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.