> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kameleoon.API.Segments

> Référence des méthodes Kameleoon.API.Segments qui lisent, réévaluent et déclenchent les segments.

Ce module fournit des méthodes pour gérer les segments et le ciblage.

## getAll

La méthode `getAll()` retourne tous les segments actifs, y compris ceux associés aux expériences, personnalisations ou suivi d'audience.

```javascript theme={null}
let segments = Kameleoon.API.Segments.getAll();
```

**Valeur de retour**

| Name | Type | Description |
| - | - | - |
| segments | Array | Liste des [objets Segment](https://docs.kameleoon.com/fr/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#segment). |

## getById

La méthode `getById()` retourne le segment pour l'ID spécifié.

```javascript theme={null}
let segment = Kameleoon.API.Segments.getById(123456);
```

**Arguments**

| Name | Type | Description |
| - | - | - |
| id | Number | ID du segment. Ce champ est obligatoire. |

**Valeur de retour**

| Name | Type | Description |
| - | - | - |
| segment | Object | [Objet Segment](https://docs.kameleoon.com/fr/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#segment). |

## getByName

La méthode `getByName()` retourne le segment pour le nom spécifié.

```javascript theme={null}
let segment = Kameleoon.API.Segments.getByName("My segment");
```

**Arguments**

| Name | Type | Description |
| - | - | - |
| name | String | Nom du segment. Ce champ est obligatoire. |

**Valeur de retour**

| Name | Type | Description |
| - | - | - |
| segment | Object | [Objet Segment](https://docs.kameleoon.com/fr/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#segment). |

## reevaluate

La méthode `reevaluate()` force une réévaluation immédiate des conditions de ciblage pour le segment spécifié. L'évaluation se produit généralement au chargement de la page, ce qui entraîne des statuts de **true**, **false** ou **undefined**. Cette méthode redémarre le processus d'évaluation comme si le moteur venait de s'initialiser.

```javascript theme={null}
Kameleoon.API.Utils.addEventListener(document.body, "mouseleave", function (event) {
  if (event.clientY < 0) {
    Kameleoon.API.Segments.reevaluate(123456);
  }
});
```

**Arguments**

| Name | Type | Description |
| - | - | - |
| id | Number | ID du segment. Ce champ est obligatoire. |

## trigger

La méthode `trigger()` force un segment à se déclencher pour le visiteur actuel et contourne les conditions de ciblage.

```javascript theme={null}
Kameleoon.API.Segments.trigger(12345);
```

**Arguments**

| Name | Type | Description |
| - | - | - |
| id | Number | ID du segment. Ce champ est obligatoire. |