CKTIS / JavaScript
Selection.removeAllRanges() — brisanje izbora
Selection.removeAllRanges() izprazni izbor dokumenta, ne da bi izbrisal besedilo ali vozlišča. Metoda ne sprejme argumentov in vrne undefined.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
selection.removeAllRanges()Selection.removeAllRanges() odstrani obseg iz izbora. Po klicu je rangeCount enak 0, anchorNode in focusNode pa sta null. Ponovni klic pri praznem izboru ničesar ne spremeni.
Ne izbriše vsebine ali shranjenega objekta Range. Za razliko od collapseToStart() ne pusti obsega, skrčenega na mesto kazalke. empty() je vzdevek za to metodo.
To je vmesnik brskalniškega Selection API, ne funkcija ECMAScript; Node 24 ne potrjuje njegove razpoložljivosti. Preverite podporo v ciljnem brskalniku. Primer primerja prazen izbor z nespremenjenim besedilom in ohranjenim obsegom.
Primeri
(() => {
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();
})();Rezultat
{"rangeCount":0,"anchorNode":null,"focusNode":null,"text":"Hello","savedRange":"Hello"}Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.