KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URL — adressen parsen en aanpassen

URL splitst een adres op in onderdelen, lost relatieve verwijzingen op en maakt het mogelijk queryparameters aan te passen.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new URL(url, base?)

URL is een WHATWG-API, geen onderdeel van ECMAScript. new URL(url, base?) parseert een adres; voor relatieve verwijzingen is een basis nodig. Als het parsen mislukt, wordt een TypeError gegenereerd.

href geeft het volledig geserialiseerde adres, terwijl pathname het pad geeft. Bij HTTP(S) bevat origin het schema, de host en eventueel de poort, maar niet het pad. Oplossen ten opzichte van een basis is geen aaneenschakeling: een afsluitende / is van belang.

searchParams is een gekoppeld URLSearchParams-object: wijzigingen eraan werken het adres bij. Geef waarden door zonder ze vooraf te coderen; spaties worden als + geserialiseerd. Dat het parsen lukt, betekent niet dat een adres veilig is — controleer of protocol en origin zijn toegestaan.

Voorbeelden

const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);

Resultaat

/app/items
https://example.com/app/items?q=red+shoes

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen