> ## 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).

# 🟪 Parcourir un Objet

# 🟪 Parcourir un Objet

${frame}[Vidéo : anatomie du bloc Parcourir un objet](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/loopthroughobject.html)

![Parcourir un Objet](https://celestory-docs-illustrations.netlify.app/fr/ParcourirunObjet_FR.svg)

Le bloc Parcourir un Objet permet d'itérer automatiquement sur toutes les propriétés (clé/valeur) d'une variable de type Objet, une par une.

C'est l'équivalent, pour les Objets, du bloc "Répétition" utilisé sur les listes : il permet d'exécuter une même portion de graphe pour chaque propriété sans avoir à connaître leur nombre ni leur nom à l'avance.

## 📥 Entrées

-   in (Flux) : Point d'entrée qui démarre (ou relance) le parcours de l'objet.
-   objet (Objet) : La variable de type Objet à parcourir.

## 📤 Sorties

-   out (Trigger) : S'active une fois par propriété de l'objet, tant qu'il en reste à traiter.
-   index (Nombre) : Position numérique de la propriété courante (commence à 1).
-   clé (Texte) : Le nom de la propriété courante à cette itération.
-   valeur (Variable dynamique) : La valeur associée à la clé courante.
-   end (Trigger) : S'active une seule fois, après le traitement de toutes les propriétés.

## 💡 Exemple d'utilisation

**Scénario : Afficher toutes les statistiques d'un joueur**

1. Un objet `stats` contient `{"force": 12, "agilité": 8, "magie": 15}`.
2. Un bloc Parcourir un Objet est connecté à `stats`.
3. À chaque itération, la sortie `clé` et `valeur` permettent d'afficher une ligne "force : 12", puis "agilité : 8", etc.
4. Une fois toutes les statistiques affichées, la sortie `end` poursuit le scénario.

## ⚙️ Détails Techniques

-   **Identifiant interne** : `loopThroughObject`
-   **Ordre de parcours** : Les propriétés sont généralement parcourues dans leur ordre de définition dans l'objet, sans garantie stricte si l'objet provient d'une source externe (API).
-   **Objets imbriqués** : Si une valeur est elle-même un Objet, elle est renvoyée telle quelle en sortie `valeur` — utilisez un second bloc Parcourir un Objet pour la traiter à son tour.

---

*Version documentée : v3*