CKTIS / JavaScript
window.getSelection() — sélection du document
window.getSelection() expose l’objet Selection du document actuel, qui permet de lire et de modifier sa sélection.
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
window.getSelection()window.getSelection() ne prend aucun argument et délègue à document.getSelection(). Selon la spécification, la méthode renvoie un objet Selection, ou null si le document n’a pas de contexte de navigation. Firefox peut aussi renvoyer null pour un iframe avec display:none, même si son document possède un contexte de navigation. Vérifiez que le résultat n’est pas null avant de l’utiliser. Un objet Selection n’est pas une chaîne ; lisez son texte avec selection.toString().
L’absence de sélection ne signifie pas que la valeur est null : vérifiez rangeCount avant d’appeler getRangeAt(0) pour éviter IndexSizeError. isCollapsed indique que les extrémités coïncident ; cela peut correspondre à un curseur ou à une sélection vide. Un Range décrit des limites, tandis que Selection représente la sélection du document.
Il s’agit d’une API Web du navigateur, et non d’une fonctionnalité ECMAScript. La présence de Node 24 ne prouve pas sa prise en charge. La spécification de la Selection API est un projet de travail, pas un tableau de compatibilité des navigateurs.
Exemples
(() => {
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();
})();Résultat
Hello selection false
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.