readonly attribute DOMString regionCode;

<li>If <var>details</var>["<a>regionCode</a>"] is present and not

the empty string:

<ol>

<li>Let <var>regionCode</var> be the result of <a>strip leading

and trailing ASCII whitespace</a> from

<var>details</var>["<a>regionCode</a>"] and then

<a data-cite="INFRA#ascii-uppercase">ASCII uppercasing</a>

the result.

</li>

<li>Let <var>putativeCountrySubdivisionCodeElement</var> be the

concatenation of <var>address</var>.<a>[[\country]]</a>, a

single U+002D (-) <a>code point</a>, and <var>regionCode</var>.

</li>

<li>

<p>

If <var>putativeCountrySubdivisionCodeElement</var> is not

a valid <a>country subdivision code element</a> as per

[[ISO3166-2]]'s section 5.2 "Structure of country

subdivision code elements" (non-normative details below),

throw a <a>RangeError</a> exception.

</p>

<div class="note" title=

"Structure of country subdivision code elements">

<p>

<strong>Do not implement from this note.</strong> The

structure of a <a>country subdivision code element</a> is

formally defined in [[ISO3166-2]] (section 5.2). Although

the structure is not expected to change at the time of

writing, implementers are expected to track updates to

[[ISO3166-2]] directly from ISO.

</p>

<p>

As [[ISO3166-2]] is not freely available to the general

public, the structure of a <a>country subdivision code

element</a> at the time of publication is as follows:

</p>

<ul>

<li>Two <a>code points</a> that match an [[ISO3166-1]]

alpha-2 country code.

</li>

<li>A single U+002D (-) <a>code point</a>.

</li>

<li>One, two, or three <a data-cite=

"INFRA#ascii-alphanumeric">ASCII alphanumeric</a> code

points, in any order.

</li>

</ul>

</div>

</li>

<li>Set <var>address</var>.<a>[[\regionCode]]</a> to

<var>regionCode</var>.

</li>

<li>If <var>details</var>["<a>region</a>"] is not present:

<ol>

<li>Let <var>region</var> be the corresponding <a>country

subdivision name</a> for <var>regionCode</var>. Where

[[ISO3166-2]] defines multiple <a>country subdivision

names</a> for a <var>regionCode</var>, it is RECOMMENDED

the user agent select one by matching on:

<ol>

<li>The <a data-cite="HTML#language">language</a> of

<a data-cite="HTML#the-body-element-2">the body

element</a>.

</li>

<li>The user's preferred languages.

</li>

<li>Any other criteria the user agent deems suitable.

</li>

</ol>

</li>

<li>Set <var>details</var>["<a>region</a>"] to

<var>region</var>.

</li>

</ol>

</li>

</ol>

</li>

<section>

<h2>

<dfn>regionCode</dfn> attribute

</h2>

<p data-link-for="">

Represents the <a>region</a> of the address as a code element of an

[[ISO3166-2]] country subdivision name (e.g., "CA" for California,

USA). When getting, returns the value of the

<a>PaymentAddress</a>'s <a>[[\regionCode]]</a> internal slot.

</p>

</section>

<tr>

<td>

<dfn>[[\regionCode]]</dfn>

</td>

<td>

The empty string, or one to three code points that represent a

<a>region</a> as the code element of an [[ISO3166-2]] country

subdivision name (i.e., the characters after the hyphen in an

ISO3166-2 <a>country subdivision code element</a>, such as "CA"

for the state of California in the USA, or "11" for the Lisbon

district of Portugal).

</td>

</tr>

DOMString regionCode;

<dt>

<dfn>regionCode</dfn> member

</dt>

<dd>

The empty string, or one to three code points that represent a

<a>region</a> as the code element of an [[ISO3166-2]] country

subdivision name (i.e., the characters after the hyphen in an

ISO3166-2 <a>country subdivision code element</a>, such as "CA" for

the state of California in the USA, or "11" for the Lisbon district

of Portugal).

</dd>

DOMString regionCode;

<dt>

<dfn>regionCode</dfn> member

</dt>

<dd>

Denotes that the region code representation of the <a>region</a>

has a validation error. In the user agent's UI, this member

corresponds to the input field that provided the

<a>PaymentAddress</a>'s <a data-link-for=

"PaymentAddress">regionCode</a> attribute's value.

</dd>

<a data-link-for="PaymentAddress">region</a> and

<a data-link-for="PaymentAddress">regionCode</a> attributes - but

the address can still serve its intended purpose (e.g., be valid

for shipping or billing purposes).

<li>If <var>details</var>["<a>region</a>"] has a corresponding

<a>country subdivision code element</a>, set

<var>details</var>["<a>regionCode</a>"] to that <a>country

subdivision code element</a>.

</li>