Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Selection.removeAllRanges() — effacer la sélection

Selection.removeAllRanges() vide la sélection du document sans supprimer le texte ni les nœuds. Cette méthode ne prend aucun argument et renvoie undefined.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

selection.removeAllRanges()

Selection.removeAllRanges() dissocie le range de la sélection. Après l’appel, rangeCount vaut 0, et anchorNode ainsi que focusNode valent null. Un nouvel appel sur une sélection vide ne change rien.

La méthode ne supprime ni le contenu ni un objet Range conservé. Contrairement à collapseToStart(), elle ne laisse aucun range réduit à un curseur. empty() est un alias de cette méthode.

Il s’agit d’une interface de la Selection API du navigateur, et non d’une fonctionnalité ECMAScript ; Node 24 ne confirme pas sa disponibilité. Vérifiez la prise en charge dans le navigateur cible. L’exemple oppose la sélection vide au texte inchangé et au range conservé.

Exemples

(() => {
  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();
})();

Résultat

{"rangeCount":0,"anchorNode":null,"focusNode":null,"text":"Hello","savedRange":"Hello"}

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources