本文へ移動

address-plusアドレスプラス

住所を端末の中で解析・確認・整形・比較し、国のモジュールや任意のフォームの入力欄を使えます。

address-plusは、parse-addressの使い方を広げ、型付きの結果、確認、書式、国のモジュールを加えます。 名前について(英語)

目次

やり方

確認の結果を使う

エラーと警告を示し、配達の保証とは区別します。

必須の項目を選ぶ

import { validateAddress } from "@johnmorrisdotca/address-plus";
const result=validateAddress("123 Main St",{requirePostalCode:true});
console.log(result.isValid,result.errors.map(finding=>finding.code),result.warnings.length);
false [ 'MISSING_POSTAL_CODE' ] 2

フォームや取り込みの目的に合わせ、標準の必須項目を使います。エラーは有効性に関係し、警告は不一致の可能性を示しますが、必ず無効になるとは限りません。元の入力と結果のコードを保ち、示した項目を修正できるようにします。郵便番号と地域の確認は、人、建物、配達先の存在の確認ではありません。

国の解析結果を確認する

import { parseFrenchAddress,validateFrenchAddress } from "@johnmorrisdotca/address-plus/fr";
const address=parseFrenchAddress("12 bis rue de la Paix, 75002 Paris");
if(!address) throw new Error("This example did not parse.");
console.log(validateFrenchAddress(address).errors.length===0);
true

国ごとの確認には、その標準の解析結果を渡します。解析のnullを確かめてから次に渡します。validateAddressは主な入口の入力と設定を受けますが、国の確認も同じ引数とは限りません。入力欄のoptions.validationは標準の設定をすべて使え、公開のイベントは状態と件数を伝えます。入力欄の扱いを読めます。

ソースを見るGitHub で編集@johnmorrisdotca/address-plus 1.7.0 のソースから作成しました。

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。