> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟪 Récupérer d'un Objet

# 🟪 Récupérer d'un Objet

${frame}[Vidéo : anatomie du bloc Récupérer d'un objet](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/getfromobject.html)

![Récupérer d'un Objet](https://celestory-docs-illustrations.netlify.app/fr/RecupererdunObjet_FR.svg)

Le bloc Récupérer d'un Objet permet de lire une valeur précise à l'intérieur d'une variable de type Objet (une donnée structurée en clé/valeur, comme un JSON).

C'est l'équivalent du bloc "Récupérer d'une liste", mais pour des données identifiées par un nom plutôt que par une position. Il est utile pour lire une information précise dans une fiche joueur, une réponse d'API, ou toute autre donnée structurée importée dans le projet.

## 📥 Entrées

-   objet (Objet) : La variable de type Objet dans laquelle chercher.
-   chemin (Texte) : Le chemin vers la valeur recherchée dans l'objet (ex : `score`, `nom`, ou `adresse.ville` pour une valeur imbriquée).
-   défaut (Texte, Nombre, Booléen, Liste ou Objet) : La valeur renvoyée si le chemin est introuvable (ou si la valeur trouvée est vide/`null`).

## 📤 Sorties

-   valeur (Variable dynamique) : La valeur trouvée au chemin demandé. Son type s'ajuste automatiquement selon ce qui est trouvé (texte, nombre, liste, objet imbriqué...).
-   trouvé (Booléen) : `true` si une valeur a été trouvée au chemin demandé (une valeur `null` compte comme "non trouvée").

## 💡 Exemple d'utilisation

**Scénario : Afficher le score d'un joueur reçu depuis une API**

1. Une requête HTTP renvoie un objet joueur contenant `{"nom": "Alice", "score": 1200}`.
2. Vous voulez afficher seulement le score dans une bulle de dialogue.
3. Ajoutez un bloc Récupérer d'un Objet, et reliez la variable objet reçue à l'entrée objet.
4. Tapez `score` dans l'entrée chemin.
5. La sortie valeur renvoie `1200`, prête à être affichée ou utilisée dans la suite du flux.

## ⚙️ Détails Techniques

-   **Identifiant interne** : `getFromObject`
-   **Chemins imbriqués** : Pour accéder à une propriété imbriquée, on utilise un chemin en notation pointée (ex : `adresse.ville`) ou avec des crochets pour un élément de liste (ex : `items[0].id`).
-   **Valeur introuvable** : Si le chemin ne mène à aucune valeur (ou à une valeur vide), la sortie valeur renvoie la valeur défaut et la sortie trouvé indique `false` — plutôt que de casser le flux silencieusement.

---

*Version documentée : v3*