PaymentAddress.regionCode

The regionCode read-only attribute of the PaymentAddress interface returns a one-, two-, or three-alphanumeric code (DOMString) representing the region of the address (e.g., "CA" for California, or "11" for Lisbon, Portugal).

The code is derived from the ISO 3166-2 standard, which defines codes for identifying the subdivisions (e.g., states, provinces, autonomous regions, etc.) of all countries in the world.

If the browser can't determine the region code, or the country doesn't use regions for postal addresses, it returns an empty string.

Syntax

var regionCode = paymentAddress.regionCode;

Value

A DOMString indicating the one to three character alphanumeric code representing the region portion of the address. This should correspond to region, but should be the ISO 3166--2 standard's region code. The string is empty if the region code couldn't be determined, isn't needed for the address's country, or was not provided.

Specifications

Specification Status Comment
Payment Request API
The definition of 'PaymentAddress.regionCode' in that specification.
Candidate Recommendation Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
regionCodeChrome No support NoEdge ? Firefox Full support 64
Notes Disabled
Full support 64
Notes Disabled
Notes Available only in nightly builds. Requires the comma-delineated list in dom.payments.request.supportedRegions to contain one or more of the supported 2-character ISO locales, currently US and CA.
Disabled From version 64: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE No support NoOpera No support NoSafari ? WebView Android No support NoChrome Android No support NoEdge Mobile ? Firefox Android Full support 64
Notes Disabled
Full support 64
Notes Disabled
Notes Available only in nightly builds. Requires the comma-delineated list in dom.payments.request.supportedRegions to contain one or more of the supported 2-character ISO locales, currently US and CA.
Disabled From version 64: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android No support NoSafari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.
User must explicitly enable this feature.
User must explicitly enable this feature.

See also