aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/document/head/index.md
blob: b0ecd73b49d42e95020bbd2010a2101f41667023 (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
43
44
45
---
title: document.head
slug: Web/API/Document/head
tags:
  - DOM
  - Document
  - HTML5
translation_of: Web/API/Document/head
---
Retourne l'élément {{HTMLElement("head")}} du document courant. S'il y a plus d'un élément \<head>, le premier est retourné.

## Syntaxe

    var objRef = document.head;

## Exemple

```js
// en HTML: <head id="my-document-head">
var aHead = document.head;

alert(aHead.id); // "my-document-head";

alert( document.head === document.querySelector("head") ); // true
```

## Notes

`document.head` est en lecture seule. Essayer d'assigner une valeur à cettre propriété échouera en silence ou lancera une `TypeError` si le mode strict d'ECMAScript est activé dans un navigateur Gecko.

## Spécifications

| Spécification                                                                                    | Statut                           | Commentaire         |
| ------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------- |
| {{SpecName('HTML5.1','dom.html#dom-document-head','Document.head')}}     | {{Spec2('HTML5.1')}}     |                     |
| {{SpecName('HTML5 W3C','dom.html#dom-document-head','Document.head')}}     | {{Spec2('HTML5 W3C')}}     |                     |
| {{SpecName('HTML WHATWG','dom.html#dom-document-head','Document.head')}} | {{Spec2('HTML WHATWG')}} | Initial definition. |

## Compatibilité des navigateurs

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

## Voir aussi

- {{domxref("document.body")}}