# Filtrer - Nœud de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/filter

Language: fr

Conserver uniquement les éléments correspondant à une condition

## Utilisation et spécificités

Utilisez Filtrer pour retirer des éléments d’une liste avant de la parcourir ou de l’envoyer à une autre étape. À la différence d’un [IF](/docs/nodes/if), ce nœud ne choisit pas une branche : il produit une liste dans `items`.

Par exemple, avec l’entrée manuelle `{ "contacts": [{ "name": "Ada", "active": true }, { "name": "Lin", "active": false }] }`, renseignez :

- Source : `input.contacts`.
- Champ : `active`, lu à l’intérieur de chaque contact.
- Opérateur : `equals` ; valeur : `true`.

La sortie attendue est :

```json
{
  "items": [{ "name": "Ada", "active": true }],
  "count": 1,
  "removed": 1,
  "combinator": "and"
}
```

Avec AND, un élément doit satisfaire toutes les conditions ; avec OR, une seule suffit. Le champ est un chemin relatif à l’élément, comme `profile.active`, et non une expression `input.contacts...`. Pour exécuter une action par contact conservé, utilisez une boucle dont la source pointe sur `nodes.filter1.items`. Le [parcours sur les listes](/docs/working-with-lists) montre la chaîne complète.

Type technique : `filter`. Runtime : `nodulz`.

## Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le [guide des identifiants](/docs/credentials) si une source distante ou une cible d’exécution nécessite un accès.

## Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `source` | `string` | `""` | - |
| `combinator` | `enum` | `"and"` | `and`, `or` |
| `conditions` | `array` | `[{"field":"","operator":"equals","value":""}]` | - |
| `conditions[].field` | `string` | `""` | - |
| `conditions[].operator` | `enum` | `"equals"` | `equals`, `not_equals`, `contains`, `not_contains`, `gt`, `gte`, `lt`, `lte`, `empty`, `not_empty` |
| `conditions[].value` | `string` | `""` | - |
| `field` | `string` | - | - |
| `operator` | `enum` | - | `equals`, `not_equals`, `contains`, `not_contains`, `gt`, `gte`, `lt`, `lte`, `empty`, `not_empty` |
| `value` | `string` | - | - |

## Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

```json
{
  "source": "",
  "combinator": "and",
  "conditions": [
    {
      "field": "",
      "operator": "equals",
      "value": ""
    }
  ]
}
```

## Vérification

Testez un contact actif, un inactif et une liste vide. Vérifiez `count` et `removed`, puis le contenu de `items`. Si tous les éléments disparaissent, vérifiez d’abord le champ relatif et la valeur comparée. Une liste vide est un résultat possible, pas un échec du nœud.

Voir aussi : [Expressions et données](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)