📞 Phone Helper

Validatie, formatting en normalisatie van telefoonnummers per land.

← Terug naar Core Library

📖 Introductie

De Phone Helper bevat utility functies voor het valideren, formatteren en normaliseren van telefoonnummers. De logica is land-specifiek en wordt server-side gevalideerd via een Dataverse Custom API.

👉 Deze helper zorgt voor consistente en correcte verwerking van telefoonnummers in internationale scenario’s.
⚠️ Deze helper is afhankelijk van een Custom API en werkt niet zonder server-side ondersteuning.

📦 Functionaliteit

✅ Validatie

  • isValid(number, country) → controleert geldigheid (async)

🧾 Formatting

  • format(number, country, formatStyle) → zet nummer om naar gewenst formaat

🌍 Normalisatie

  • normalize(number, country) → zet om naar E.164 formaat

📘 Voorbeeld

  • getExample(country, formatStyle) → geeft voorbeeldnummer

⚙️ Werking

De Phone Helper gebruikt een centrale Dataverse Custom API om alle operaties uit te voeren.

👉 Werkwijze:
  • Input wordt doorgestuurd naar API (nummer + landcode)
  • API verwerkt validatie en formatting
  • Resultaat wordt teruggegeven aan de client

🔌 Custom API

brenke_phone

Operaties

Operation Beschrijving
ISVALID Controleert of nummer geldig is
FORMAT Formatteert nummer
NORMALIZE Zet om naar E.164 formaat
EXAMPLE Geeft voorbeeldnummer

Parameters

Naam Omschrijving
brenke_phone_country Landcode (bijv. NL, BE)
brenke_phone_number Telefoonnummer
brenke_phone_operation Type operatie
brenke_phone_formatstyle Formaat (bijv. E.164)

Response

Field Omschrijving
brenke_phone_isvalid Validatie resultaat
brenke_phone_formatted Geformatteerd nummer
brenke_phone_normalized Genormaliseerd nummer

⚠️ Belangrijke aandachtspunten

  • Alle functies zijn async → gebruik altijd await
  • Validatie is server-side (land-afhankelijk correct)
  • Country is verplicht
  • Format styles bepalen output (bijv. E.164)
⚠️ Werkt alleen wanneer de Custom API actief en beschikbaar is.

💡 Voorbeelden

Validatie

const valid = await core.Phone.isValid("0612345678", "NL");
// true / false / null

Formatteren

const formatted = await core.Phone.format("0612345678", "NL", "E.164");
// "+31612345678"

Normaliseren

const normalized = await core.Phone.normalize("0612345678", "NL");
// "+31612345678"

Voorbeeldnummer

const example = await core.Phone.getExample("NL", "E.164");
// "+31 6 12345678"

📊 Samenvatting

✅ Telefoon validatie per land
✅ Formatting (E.164 en andere formats)
✅ Normalisatie
✅ Server-side correctheid via API