KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

`URL.origin`, `URL.pathname` en `URL.search`

Onderscheid de herkomst, het pad en de query van een geparseerde URL en lees afzonderlijke parameters zonder het adres zelf op te splitsen.

Versie: Current web platform; runtime support varies

Syntax

const url = new URL(input);
const resolved = new URL(input, base);

url.origin;
url.pathname;
url.search;

url.pathname = "/catalog";
url.search = "page=2";

origin, pathname en search zijn eigenschappen van een URL-instantie, geen methoden. URL is een API van het webplatform en geen onderdeel van ECMAScript 2024. Controleer dus of je runtime de API aanbiedt. Gebruik new URL(input) voor een absolute URL en geef bij een relatieve verwijzing een geschikte basis op met new URL(input, base). Als de opgegeven basis ongeldig is of het parsen mislukt, gooit de constructor een TypeError. Het wijzigen van het URL-object leidt niet tot navigatie.

origin is alleen-lezen. Voor HTTP(S) bevat deze eigenschap het schema, de hostnaam en het poortnummer als dit afwijkt van de standaard. Inloggegevens, pad, query en fragment horen er niet bij. Een ondoorzichtige herkomst, zoals bij een data:-URL, wordt geserialiseerd als de tekenreeks "null", niet als de waarde null. Twee zulke tekenreeksen bewijzen niet dat de herkomst dezelfde is. Het resultaat voor file: hangt af van de implementatie.

pathname is het geserialiseerde pad zonder query of fragment. Voor HTTP(S) begint het met / en is het hoofdpad /. Procentgecodeerde reeksen zoals %20 worden niet automatisch gedecodeerd. Je kunt een nieuw HTTP(S)-pad toewijzen. Andere schema’s kunnen een ondoorzichtig pad hebben zonder / aan het begin.

search geeft de query terug met de voorafgaande ?, zonder fragment en zonder procentgecodeerde reeksen te decoderen. Ontbreekt de query of is hij leeg, bijvoorbeeld bij een losse ?, dan krijg je "". Je kunt een nieuwe query met of zonder voorafgaande ? toewijzen; met "" verwijder je de query.

Gebruik url.searchParams.get("q") voor de gedecodeerde waarde van een parameter. Een wijziging aan searchParams werkt hetzelfde URL-object bij en kan bestaande waarden anders serialiseren: een spatie die als %20 is geschreven, kan + worden. Lees href voor de volledige URL, inclusief het fragment.

Voorbeelden

{
  const url = new URL("/catalog/./tea%20sets?q=green%20tea#reviews", "https://shop.example:443/");
  console.log(url.origin);
  console.log(url.pathname);
  console.log(url.search);
  console.log(url.searchParams.get("q"));

  url.searchParams.set("page", "2");
  console.log(url.href);
}

Resultaat

https://shop.example
/catalog/tea%20sets
?q=green%20tea
green tea
https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews

Bij normalisatie verdwijnen de standaardpoort `443` en het padsegment `.`. `search` behoudt `%20`, `get("q")` geeft een waarde met een spatie terug en door `page=2` toe te voegen wordt die spatie in de query weergegeven als `+`.

Gerelateerde lessen

  • JavaScript · Les 38 · Gevorderd · Versie: 4

Bronnen