# node: getLocaleProperties
URL: https://generaltranslation.com/fr/docs/node/api/get-locale-properties.mdx
---
title: getLocaleProperties
description: Référence de l’API pour la fonction getLocaleProperties
---

## Vue d’ensemble

La fonction `getLocaleProperties` renvoie des métadonnées sur un paramètre régional donné, notamment son nom, son nom dans sa langue d’origine, sa langue, sa région et des informations sur son système d’écriture.

```js
import { getLocaleProperties } from 'gt-node';

const props = getLocaleProperties('en-US');
console.log(props.name); // 'Anglais américain'
```


## Référence

### Paramètres

| Paramètre | Type     | Description                                                                                                                |
| --------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
| `locale`  | `string` | Un code de langue BCP 47 (par exemple `'en-US'`, `'ja'`). S’il n’est pas fourni, le paramètre régional actuel est utilisé. |

### Renvoie

Un objet `LocaleProperties` avec les champs suivants :

| Champ                      | Type     | Description                                                                        |
| -------------------------- | -------- | ---------------------------------------------------------------------------------- |
| `code`                     | `string` | Le code de langue (par ex. `'en-US'`).                                             |
| `name`                     | `string` | Le nom anglais du paramètre régional (par ex. `'American English'`).               |
| `nativeName`               | `string` | Le nom du paramètre régional dans sa propre langue (par ex. `'American English'`). |
| `languageCode`             | `string` | Le sous-tag de langue (par ex. `'en'`).                                            |
| `languageName`             | `string` | Le nom anglais de la langue (par ex. `'English'`).                                 |
| `nativeLanguageName`       | `string` | Le nom de la langue dans sa propre langue (par ex. `'English'`).                   |
| `nameWithRegionCode`       | `string` | Le nom du paramètre régional, région incluse (par ex. `'English (US)'`).           |
| `nativeNameWithRegionCode` | `string` | Le nom natif du paramètre régional, région incluse.                                |
| `regionCode`               | `string` | Le sous-tag de région (par ex. `'US'`).                                            |
| `regionName`               | `string` | Le nom anglais de la région (par ex. `'United States'`).                           |
| `nativeRegionName`         | `string` | Le nom de la région dans la langue du paramètre régional.                          |
| `scriptCode`               | `string` | Le sous-tag d’écriture (par ex. `'Latn'`).                                         |
| `scriptName`               | `string` | Le nom anglais du système d’écriture (par ex. `'Latin'`).                          |
| `nativeScriptName`         | `string` | Le nom du système d’écriture dans la langue du paramètre régional.                 |
| `maximizedCode`            | `string` | Le code de langue entièrement développé (par ex. `'en-Latn-US'`).                  |

***

## Exemples

### Utilisation de base

```js title="handler.js"
import { getLocaleProperties } from 'gt-node';

app.get('/api/locale-info', (req, res) => {
  const props = getLocaleProperties('ja');
  res.json({
    name: props.name,           // 'Japanese'
    nativeName: props.nativeName, // '日本語'
    script: props.scriptName,   // 'Japanese'
  });
});
```

***


## Remarques

* Cette fonction est synchrone — il n’est pas nécessaire d’utiliser `await`.
* Utile pour créer des sélecteurs de paramètres régionaux ou pour afficher aux utilisateurs des métadonnées sur le paramètre régional.

## Étapes suivantes

* Consultez [`getLocale`](/docs/node/api/get-locale) pour connaître le paramètre régional de la requête en cours.
* Pour en savoir plus, consultez [les codes de langue](/docs/core/locales).