ContactAddress

Instanzeigenschaften

ContactAddress.addressLine Schreibgeschützt

Ein Array von Zeichenfolgen mit den einzelnen Adresszeilen, die nicht durch die anderen Eigenschaften abgedeckt sind. Die genaue Anzahl und der Inhalt variieren je nach Land oder Ort. Enthalten sein können beispielsweise ein Straßenname, eine Hausnummer, eine Wohnungsnummer, eine ländliche Zustellroute, beschreibende Zustellhinweise oder eine Postfachnummer.

ContactAddress.country Schreibgeschützt

Eine Zeichenfolge, die das Land angibt, in dem sich die Adresse befindet, gemäß dem Standard ISO 3166-1 Alpha-2. Die Zeichenfolge wird immer in ihrer kanonischen Form mit Großbuchstaben angegeben. Beispiele für gültige country-Werte sind "US", "GB", "CN" und "JP".

ContactAddress.city Schreibgeschützt

Eine Zeichenfolge, die die Stadt oder den Ort der Adresse angibt.

ContactAddress.dependentLocality Schreibgeschützt

Eine Zeichenfolge, die einen untergeordneten Ort oder Ortsteil innerhalb einer Stadt angibt, beispielsweise ein Viertel, einen Stadtbezirk, einen Bezirk oder eine „dependent locality“ im Vereinigten Königreich.

ContactAddress.organization Schreibgeschützt

Eine Zeichenfolge, die den Namen der Organisation, Firma, des Unternehmens oder der Einrichtung an der Adresse angibt.

ContactAddress.phone Schreibgeschützt

Eine Zeichenfolge, die die Telefonnummer des Empfängers oder der Kontaktperson angibt.

ContactAddress.postalCode Schreibgeschützt

Eine Zeichenfolge, die eine für die Postsortierung verwendete Kennung angibt, beispielsweise den ZIP-Code in den Vereinigten Staaten oder den PIN-Code in Indien.

ContactAddress.recipient Schreibgeschützt

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

ContactAddress.region Schreibgeschützt

Eine Zeichenfolge, die die oberste Verwaltungseinheit des Landes angibt, beispielsweise einen Bundesstaat, eine Provinz, eine Oblast oder eine Präfektur.

ContactAddress.sortingCode Schreibgeschützt

Eine Zeichenfolge mit einem Postsortiercode, wie er beispielsweise in Frankreich verwendet wird.

Instanzmethoden

ContactAddress.toJSON()

Gibt ein einfaches, JSON-serialisierbares Objekt zurück, das das ContactAddress-Objekt repräsentiert. Wird automatisch von JSON.stringify() aufgerufen.

Beispiele

Das folgende Beispiel fordert die Benutzerin oder den Benutzer auf, Kontakte auszuwählen, und gibt anschließend die erste zurückgegebene Adresse auf 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