---
title: window.getSelection
slug: Web/API/Window/getSelection
translation_of: Web/API/Window/getSelection
---
{{ ApiRef() }}

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 {{DOMxRef("Selection")}}.

## Exemple

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

## Notes

En [JavaScript](fr/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`](fr/DOM/Selection/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](fr/DOM/window.alert). Cependant, pour utiliser une propriété ou méthode JavaScript de [String](fr/JS/String) comme [`length`](fr/JS/String.prototype.length) ou [`substr`](fr/JS/String.prototype.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

## Spécification

DOM Level 0. Ne fait partie d'aucune spécification.

## Voir aussi

- [Selection API](../Selection_API)
- [`Selection`](../Selection)
- [`Range`](../Range)
- [`Document.getSelection()`](../Document/getSelection)
- [`HTMLInputElement.setSelectionRange()`](../HTMLInputElement/setSelectionRange)