CKTIS / JavaScript
Selection.removeAllRanges() — de selectie wissen
Selection.removeAllRanges() maakt de documentselectie leeg zonder tekst of knooppunten te verwijderen. De methode krijgt geen argumenten en retourneert undefined.
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
selection.removeAllRanges()Selection.removeAllRanges() koppelt het bereik los van de selectie. Daarna is rangeCount gelijk aan 0 en zijn anchorNode en focusNode null. Nogmaals aanroepen bij een lege selectie verandert niets.
De methode verwijdert noch inhoud, noch een bewaard Range-object. Anders dan collapseToStart() laat ze geen bereik achter dat is samengevouwen tot een invoegpunt. empty() is een alias voor deze methode.
Dit is een interface van de browser-Selection API, geen ECMAScript-functie; Node 24 bevestigt niet dat deze beschikbaar is. Controleer de ondersteuning in de doelbrowser. Het voorbeeld zet de lege selectie af tegen de ongewijzigde tekst en het bewaarde bereik.
Voorbeelden
(() => {
const selection = window.getSelection();
if (!selection || typeof selection.removeAllRanges !== "function") {
throw new Error("Selection API unavailable");
}
const text = document.createTextNode("Hello");
document.body.append(text);
const range = document.createRange();
range.selectNodeContents(text);
selection.removeAllRanges();
selection.addRange(range);
selection.removeAllRanges();
console.log(JSON.stringify({
rangeCount: selection.rangeCount,
anchorNode: selection.anchorNode,
focusNode: selection.focusNode,
text: text.data,
savedRange: range.toString()
}));
text.remove();
})();Resultaat
{"rangeCount":0,"anchorNode":null,"focusNode":null,"text":"Hello","savedRange":"Hello"}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.