DasContactAddress Interface derContact Picker API repräsentiert eine physische Adresse. Instanzen dieses Interfaces werden aus deraddress-Eigenschaft der Objekte abgerufen, die durchContactsManager.getProperties() zurückgegeben werden.

Es kann nützlich sein, auf die Materialien desAddressing S42 Standards der Universal Postal Union zu verweisen, die Informationen über internationale Standards für Postadressen bereitstellen.

Instanz-Eigenschaften

ContactAddress.addressLineSchreibgeschütztExperimentell

Ein Array von Zeichenketten, das jede Zeile der Adresse bereitstellt, die nicht unter die anderen Eigenschaften fällt. Die genaue Größe und der Inhalt variieren je nach Land oder Region und können beispielsweise einen Straßennamen, Hausnummer, Wohnungsnummer, ländliche Lieferroute, beschreibende Anweisungen oder Postfachnummer enthalten.

ContactAddress.countrySchreibgeschütztExperimentell

Eine Zeichenkette, die das Land angibt, in dem sich die Adresse befindet, gemäß demISO-3166-1 alpha-2 Standard. Die Zeichenkette wird immer in ihrer kanonischen Großschreibweise angegeben. Einige Beispiele für gültige Werte voncountry:"US","GB","CN" oder"JP".

ContactAddress.citySchreibgeschütztExperimentell

Eine Zeichenkette, die den Stadt- oder Ortsteil der Adresse enthält.

ContactAddress.dependentLocalitySchreibgeschütztExperimentell

Eine Zeichenkette, die die abhängige Ortschaft oder Sublokalität innerhalb einer Stadt angibt, zum Beispiel ein Stadtviertel, Bezirk oder UK-abhängige Ortschaft.

ContactAddress.organizationSchreibgeschütztExperimentell

Eine Zeichenkette, die den Namen der Organisation, Firma, des Unternehmens oder der Institution an der Adresse angibt.

ContactAddress.phoneSchreibgeschütztExperimentell

Eine Zeichenkette, die die Telefonnummer des Empfängers oder Ansprechpartners angibt.

ContactAddress.postalCodeSchreibgeschütztExperimentell

Eine Zeichenkette, die einen von einer Gerichtsbarkeit für die Postzustellung verwendeten Code angibt, zum Beispiel die Postleitzahl in den Vereinigten Staaten oder der PIN-Code in Indien.

ContactAddress.recipientSchreibgeschütztExperimentell

Eine Zeichenkette, die den Namen des Empfängers, Käufers oder Ansprechpartners an der Adresse angibt.

ContactAddress.regionSchreibgeschütztExperimentell

Eine Zeichenkette, die die höchste Verwaltungseinheit des Landes enthält, zum Beispiel einen Staat, eine Provinz, ein Oblast oder eine Präfektur.

ContactAddress.sortingCodeSchreibgeschütztExperimentell

Eine Zeichenkette, die einen Postsortiercode wie in Frankreich verwendet bereitstellt.

Instanz-Methoden

ContactAddress.toJSON()Experimentell

Ein standardisierter Serializer, der eine JSON-Darstellung der Eigenschaften desContactAddress Objekts zurückgibt.

Beispiele

Das folgende Beispiel fordert den Benutzer auf, Kontakte auszuwählen, und gibt dann die erste zurückgegebene Adresse in der Konsole aus.

const props = ["address"];const opts = { multiple: true };async function getContacts() {  try {    const contacts = await navigator.contacts.select(props, opts);    const contactAddress = contacts[0].address[0];    console.log(contactAddress);  } catch (ex) {    // Handle any errors here.  }}

Spezifikationen

Browser-Kompatibilität