KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URL.hash en URL.href: fragment en volledige URL

Gebruik `hash` om het fragment te lezen of te wijzigen en `href` om de volledige URL te lezen of te vervangen. Aan `hash` alleen zie je niet of een fragment leeg is of ontbreekt.

Versie: Current web platform; runtime support varies

Syntax

const url = new URL(input, base); // Omit base for an absolute input.
url.hash;                        // Fragment string
url.hash = fragment;
url.href;                        // Full serialized URL
url.href = absoluteUrl;

hash en href zijn eigenschappen van een URL-instantie, geen methoden of statische eigenschappen. url.hash geeft een niet-leeg fragment terug met de # ervoor, of "" als het fragment leeg is of ontbreekt. url.href geeft de volledige geserialiseerde URL terug, inclusief de querystring als die er is. Een afsluitende # in href maakt het verschil zichtbaar tussen een leeg en een ontbrekend fragment.

Wijs de fragmenttekst aan url.hash toe met of zonder # aan het begin. Tekens zoals spaties worden waar nodig met procentcodering gecodeerd, maar worden bij het lezen niet automatisch gedecodeerd. url.hash = "" verwijdert het fragment; url.hash = "#" laat een leeg fragment staan. Het fragment staat los van de query: url.searchParams werkt met queryparameters en het fragment wordt niet automatisch in een HTTP-verzoek naar de server gestuurd.

Een toewijzing aan url.href ontleedt de nieuwe waarde en vervangt de hele URL in hetzelfde object. Als het ontleden mislukt, wordt een TypeError gegenereerd. De setter lost relatieve verwijzingen niet op ten opzichte van de huidige URL; gebruik daarvoor new URL(relative, base).href met een geldige basis-URL.

Een URL-object wijzigen start geen navigatie, anders dan een toewijzing aan window.location.href. Controleer voordat je naar een niet-vertrouwde URL navigeert of het schema en de origin zijn toegestaan: een URL is niet veilig alleen omdat die kan worden ontleed. URL is een API van het webplatform en geen onderdeel van ECMAScript 2024; de beschikbaarheid hangt af van de uitvoeringsomgeving.

Voorbeelden

{
  const url = new URL("https://example.com/guide?lang=en");
  const show = () => console.log(JSON.stringify([url.hash, url.href]));

  url.hash = "quick start";
  show();

  url.hash = "#";
  show();

  url.hash = "";
  show();

  url.href = "https://example.org/start#intro";
  show();
}

Resultaat

["#quick%20start","https://example.com/guide?lang=en#quick%20start"]
["","https://example.com/guide?lang=en#"]
["","https://example.com/guide?lang=en"]
["#intro","https://example.org/start#intro"]

Elke regel toont `[hash, href]`. Let op `%20`, de afsluitende `#` die alleen op de tweede regel staat en de volledige vervanging van de URL op de laatste regel.

Gerelateerde lessen

  • JavaScript · Les 30 · Gevorderd · Versie: 4

Bronnen