aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/document/documenturiobject/index.md
blob: 88c81d247b1005b5545645252133e94304e27a2f (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
---
title: document.documentURIObject
slug: Web/API/Document/documentURIObject
tags:
  - API
  - DOM
  - Propriétés
  - Reference
translation_of: Web/API/Document/documentURIObject
---
{{ ApiRef("DOM") }}

La propriété en lecture seule **`Document.documentURIObject`** renvoie un objet {{ Interface("nsIURI") }} représentant l'URI du [document](/fr/docs/Web/API/document).

Cette propriété fonctionne uniquement pour les scripts privilégiés (UniversalXPConnect), comme le code des extensions. Pour le contenu Web, elle n'a aucune signification particulière et peut être utilisée comme n'importe quelle propriété personnalisée.

Dans le cas d'un code privilégié, il convient de faire attention à ne pas essayer d'obtenir ou modifier cette propriété sur un objet de contenu non enveloppé (par exemple sur l'objet `wrappedJSObject` d'un [`XPCNativeWrapper`](/fr/docs/Mozilla/Tech/Xray_vision)). Consultez les commentaires du {{ Bug(324464) }} pour plus de détails.

## Syntaxe

```js
var uri = doc.documentURIObject;
```

## Exemple

    // Vérifie que le schéma d'URI pour l'onglet courant dans Firefox est « http »,
    // en supposant que ce code s'exécute dans le contexte de browser.xul

    var uriObj = content.document.documentURIObject;
    var uriPort = uriObj.port;

    if (uriObj.schemeIs('http')) {
      ...
    }

## Spécifications

Ne fait partie d'aucune spécification.