KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

window.getSelection() — documentselectie

window.getSelection() geeft toegang tot het Selection-object van het huidige document, zodat je de selectie kunt lezen en wijzigen.

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

window.getSelection()

window.getSelection() neemt geen argumenten en delegeert aan document.getSelection(). Volgens de specificatie geeft de methode een Selection-object terug, of null als het document geen browsingcontext heeft. Firefox kan ook null teruggeven voor een iframe met display:none, zelfs als het document van dat element wel een browsingcontext heeft. Controleer of het resultaat null is voordat je het gebruikt. Een Selection-object is geen tekenreeks; lees de tekst met selection.toString().

Geen selectie betekent niet dat het resultaat null is: controleer rangeCount voordat je getRangeAt(0) aanroept, om IndexSizeError te voorkomen. isCollapsed geeft aan dat de eindpunten samenvallen; dat kan een caret of een lege selectie betekenen. Een Range beschrijft grenzen, terwijl Selection de selectie van het document vertegenwoordigt.

Dit is een browser-Web-API, geen ECMAScript-functie. De aanwezigheid van Node 24 bewijst niet dat deze API wordt ondersteund. De specificatie van de Selection API is een werkdocument, geen compatibiliteitstabel voor browsers.

Voorbeelden

(() => {
  const selection = window.getSelection();
  if (!selection) throw new Error("Selection unavailable");

  const paragraph = document.createElement("p");
  paragraph.textContent = "Hello selection";
  document.body.append(paragraph);

  const range = document.createRange();
  range.selectNodeContents(paragraph);
  selection.removeAllRanges();
  selection.addRange(range);

  console.log(selection.toString());
  console.log(selection.isCollapsed);

  selection.removeAllRanges();
  paragraph.remove();
})();

Resultaat

Hello selection
false

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