KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Location: fragment, origin, pad, query en volledige URL

Lees de vijf URL-eigenschappen van een browserdocument en herken welke toewijzingen een navigatie kunnen starten.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const loc = window.location;
loc.hash;      // string: fragment
loc.origin;    // string: URL origin (read-only)
loc.pathname;  // string: path
loc.search;    // string: query
loc.href;      // string: complete URL

// Assignments on a live Location can initiate navigation:
loc.hash = "intro";
loc.pathname = "/guide";
loc.search = "?mode=demo";
loc.href = "/guide?mode=demo#intro";

window.location geeft het Location-object dat bij het document hoort. Dit is een web-API van de browser, geen onderdeel van ECMAScript 2024. Het object weerspiegelt de huidige URL van het document; een eerder gelezen tekenreeks verandert niet mee. Gebruik new URL(window.location.href) om een afzonderlijke URL te bekijken of te wijzigen zonder te navigeren.

href is de volledige geserialiseerde URL. pathname bevat alleen het pad, zonder query of fragment. Bij HTTP(S) begint het met /, ook bij het hoofdpad. Een opaak pad zoals blank in about:blank hoeft niet met een schuine streep te beginnen. search geeft een niet-lege query met ? ervoor en hash een niet-leeg fragment met # ervoor. Ontbreekt het onderdeel of is het leeg, dan krijg je "", ook als het scheidingsteken nog in href staat. Bij het lezen wordt percentcodering niet gedecodeerd. Lees afzonderlijke queryparameters met new URLSearchParams(window.location.search).

origin is alleen-lezen en beschrijft de origin van de URL. Bij HTTP(S) bestaat die uit het schema, de hostnaam en de poort als die afwijkt van de standaardpoort. Een opake URL-origin wordt weergegeven als de tekenreeks "null", niet als de waarde null. self.origin beschrijft daarentegen de origin van de uitvoeringsomgeving: een about:blank-document kan die erven. Twee overeenkomende tekenreeksen "null" bewijzen niet dat de origins gelijk zijn.

Een toewijzing aan href kan navigatie naar een andere URL starten, ook naar een relatieve URL. Als het parsen mislukt, volgt een DOMException met de naam SyntaxError. Toewijzingen aan pathname of search kunnen navigatie starten met een gewijzigd pad of een gewijzigde query. Toewijzen aan pathname heeft geen effect bij een opaak pad. De voorlooptekens ? en # zijn bij het instellen van respectievelijk search en hash optioneel. search = "" verwijdert de query, maar hash = "" kan een afsluitende # laten staan. Als alleen het fragment verandert, wordt meestal geen nieuw document geladen.

Het lezen van een van deze vijf eigenschappen in een venster met een andere origin kan een DOMException met de naam SecurityError veroorzaken. Schrijven naar href is een uitzondering: het kan zonder leestoegang toegestaan zijn, maar de navigatiebeperkingen van de browser blijven gelden.

Voorbeelden

const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));

Resultaat

{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}

Voer de code uit in Node.js. De code leest dezelfde URL-onderdelen uit een `URL`-object in plaats van uit een `Location`-object van de browser en start geen navigatie. In de uitvoer is `"null"` een tekenreeks en begint `blank` niet met `/`.

Gerelateerde lessen

  • JavaScript · Les 38 · Gevorderd · Versie: 4

Bronnen