window.getSelection

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

Renvoie un objet selection représentant le ou les objets sélectionnés.

Syntaxe

selection = window.getSelection();

Paramètres

selection est un objet de type Selection.

Exemple

function foo() {
  var selObj = window.getSelection();
  alert(selObj);
  var selRange = selObj.getRangeAt(0);
  // travailler avec la sélection
}

En JavaScript, lorsqu'un objet de type Selection est passé à une fonction, c'est une représentation sous forme de chaîne (string), c'est-à-dire le texte sélectionné, qui lui est passée à la place. L'objet selection apparaît donc comme une chaîne, alors qu'il s'agit en réalité d'un objet possédant ses propres propriétés et méthodes. En pratique, c'est donc la valeur renvoyée par la méthode toString de l'objet Selection qui est passée. Dans l'exemple ci-dessus, selObj est automatiquement « convertie » lorsqu'elle est passée à window.alert. Cependant, pour utiliser une propriété ou méthode JavaScript de String comme length ou substr, il est nécessaire d'appeler manuellement la méthode toString. I'm treading carefully with the word "convert" here because it could be misinterpreted as a permanent convert - Maian