# node:url

`node:url` fournit les utilitaires d'URL historiques de Node aux côtés des
constructeurs globaux [`URL`](/docs/api-whatwg-url) et
[`URLSearchParams`](/docs/api-whatwg-url).

```js
const url = require("node:url");
const parsed = url.parse("https://user:pw@example.com:8080/a?x=1#h", true);
parsed.host;    // "example.com:8080"
parsed.query.x; // "1"

url.resolve("https://example.com/a/b/c", "../x");
// "https://example.com/a/x"
```

| Utilitaire | Résultat |
|---|---|
| `parse(value, parseQueryString?, slashesDenoteHost?)` | Un `UrlObject` historique ; les clés en double analysées deviennent des tableaux. |
| `format(value)` | Une chaîne construite à partir d'un objet historique ou d'une `URL` WHATWG. |
| `resolve(from, to)` | Une chaîne d'URL résolue. |
| `resolveObject(from, to)` | Un objet historique résolu. |
| `domainToASCII()` / `domainToUnicode()` | Conversion IDN. |
| `fileURLToPath()` / `pathToFileURL()` | Conversion entre URL de fichier et chemin absolu. |
| `urlToHttpOptions()` | Options pour les API de requête HTTP de Node. |

`url.URL === globalThis.URL` et
`url.URLSearchParams === globalThis.URLSearchParams`. Le nouveau code devrait
privilégier ces constructeurs WHATWG plutôt que l'analyseur historique.

## Voir aussi

- [API URL de Node.js](https://nodejs.org/api/url.html)
- [URL WHATWG](/docs/api-whatwg-url)

<!-- api-reference:start d3778894af08 -->
## Reference

**Status:** Full · 40 of 42 suite tests pass (95.2%) · since 1.1.0

### Exports

| Export | Kind | Status | Notes |
| --- | --- | --- | --- |
| `parse()` | function | Full | Parses a URL string into a UrlObject (legacy API) |
| `format()` | function | Full | Formats a URL object or WHATWG URL back into a string |
| `resolve()` | function | Full | Resolves a target URL relative to a base URL (legacy API) |
| `URL` | property | Full | The WHATWG URL class (same as global URL) |
| `URLSearchParams` | property | Full | The WHATWG URLSearchParams class (same as global URLSearchParams) |
| `domainToASCII()` | function | Full | Converts a Unicode domain name to its ASCII (Punycode) representation |
| `domainToUnicode()` | function | Full | Converts an ASCII (Punycode) domain name to Unicode |
| `fileURLToPath()` | function | Full | Converts a file: URL to a filesystem path string |
| `pathToFileURL()` | function | Full | Converts an absolute filesystem path to a file: URL |
| `urlToHttpOptions()` | function | Full | Returns an object with URL components suitable for use with http.request() |
| `resolveObject()` | function | Full | Resolves a relative URL against a source URL object, similar to a browser resolving an anchor tag |

**Tests:** [node-api `node:url`](https://github.com/elide-dev/testsuite/blob/main/reports/1.6.0%2B6e718933f/4cbcae6c33a8/node-api/node-api.md): 40 pass, 2 fail, 0 error, 3 skipped. Failing: `test-whatwg-url-custom-inspect.js`, `test-whatwg-url-custom-parsing.js`.
<!-- api-reference:end -->
