aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/document/characterset/index.md
blob: c5d756cac169f727c957a19b1dd1217807b8e620 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
---
title: Document.characterSet
slug: Web/API/Document/characterSet
tags:
  - API
  - DOM
  - Document
  - Property
  - Read-only
  - Reference
translation_of: Web/API/Document/characterSet
---
{{ApiRef("DOM")}}

**`Document.characterSet`** propriété en lecture seule, renvoie l'encodage du document en cours. Un encodage décrit l'ensemble des caractères possibles et la façon de décoder les octets en ces caractères.

> **Note :** La propriété `document.charset` et `document.inputEncoding` sont les alias de `document.characterSet`. Ne plus les utiliser.

Les utilisateurs peuvent surcharger l'encodage indiqué pour le document (transmis par l'en-tête {{HTTPHeader("Content-Type")}} ou via le {{HTMLElement("meta")}} : `<meta charset="utf-8">`) grâce au menu <kbd>Affichage → Encodage du texte</kbd>. Cela peut notamment permettre de corriger le comportement d'un document dont l'encodage indiqué est incorrect.

## Syntaxe

    var string = document.characterSet

## Exemples

```html
<button onclick="console.log(document.characterSet);">
  Affiche le jeu de caractère
</button>
<!-- logs document's character set, such as "ISO-8859-1" or "UTF-8" -->
```

## Spécifications

| Specification                                                                                    | Etat                             | Commentaires         |
| ------------------------------------------------------------------------------------------------ | -------------------------------- | -------------------- |
| {{SpecName('DOM WHATWG', '#dom-document-characterset', 'characterSet')}} | {{Spec2('DOM WHATWG')}} | Définition initiale. |

## Compatibilité des navigateurs

{{Compat("api.Document.characterSet")}}