> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/container/javascript-block.md).

# Bloc JavaScript

## Ajouter du code JavaScript statique

Commanders Act vous permet d’inclure du code JavaScript « libre » dans le conteneur de tags, sans limite de caractères, à deux endroits appelés « Code JavaScript statique ».

Les « codes JS statiques » vous permettent d’effectuer différents types d’actions, notamment :

– Corriger les problèmes liés au data layer.

Ex. : si votre variable externe « page\_name » contient des valeurs avec des caractères spéciaux, vous pouvez les supprimer ou les remplacer dans le code JavaScript statique (par exemple, remplacer « & » par « and » comme suit :

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-fa8403aad45d68f183fbc99bd2925a30d3f2e094%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Vous pouvez ainsi continuer à utiliser votre variable externe « page\_name » dans les tags en supprimant ses caractères spéciaux via le code JS statique.

– Récupérer des données absentes du data layer à partir du code source des pages du site.

Ex. : vous pouvez récupérer les champs de formulaire JQuery dans votre bloc JS statique de la manière suivante :

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-bde3c11c0fb0d930a6149d79f745b3455bdeff7c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Les « codes JS statiques » apparaissent à deux endroits dans le menu de gauche de l’interface de l’étape « EDIT » :

– Le premier code JS statique est placé avant la déclaration des variables internes, selon l’ordre d’exécution des éléments du conteneur de votre site.

– Le deuxième code JS statique est placé après la déclaration des variables internes (vous pouvez ainsi réutiliser à cet endroit les variables internes déclarées précédemment) :

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-3cd520453bcf1bae51bee071baf16040e9ae4cf2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

La même interface utilisateur est utilisée pour le code JavaScript statique, qu’il s’exécute avant ou après les variables internes. Il vous suffit de saisir le code JavaScript souhaité et de cliquer sur « SAVE ».

## Ajouter des fichiers JavaScript dynamiques

Commanders Act vous permet d’inclure des fichiers **dynamiques** **JavaScript** dans un conteneur de tags, à deux endroits appelés «**Dynamic** **JavaScript** **File(s)**».

Contrairement aux «**Static** **JavaScript** **codes**», les «**Dynamic** **JavaScript Files**» sont des fichiers JavaScript **externes** à Commanders Act, qui sont **téléchargés** puis **ajoutés** ou mis à jour dans le conteneur à chaque génération de celui-ci.

Les «**Dynamic JavaScript File(s)**» vous permettent d’effectuer différents types d’actions.

Par exemple, vous pouvez les utiliser pour importer dans votre conteneur un fichier JavaScript contenant une bibliothèque **JQuery** (si elle n’est pas déjà appelée sur votre site) ou un fichier JavaScript de conversion de devises. En important ces fichiers dans Commanders Act, vous pouvez les ajouter à vos solutions ou les utiliser pour créer de nouvelles variables (par exemple, vous pouvez mettre à jour automatiquement les devises dans les tags de vos solutions).

Les « Dynamic JavaScript File(s) » apparaissent à deux endroits dans le menu de gauche de l’étape «**EDIT**» :

* Le **premier** Dynamic JavaScript File(s) est placé avant la déclaration des variables internes, selon l’ordre d’exécution des éléments du conteneur sur votre site.
* Le **deuxième** Dynamic JavaScript File(s) est placé après la déclaration des variables internes (vous pouvez ainsi réutiliser à cet endroit les variables internes déclarées précédemment) :

  <figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-84380810675e9131731f9840a1bd137b19e4545d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

La même interface utilisateur est utilisée pour les Dynamic JavaScript File(s), qu’ils s’exécutent avant ou après les variables internes. Il vous suffit de saisir l’URL de votre fichier JavaScript et de cliquer sur «**ENREGISTRER**"».

Vous pouvez répéter cette opération pour tous les fichiers JavaScript à inclure dans votre conteneur de tag.

Attention : l’ajout de fichiers JavaScript au conteneur va **augmenter** sa taille et, par conséquent, le temps de chargement des pages.

Vous pouvez mettre à jour votre fichier dynamique **manuellement** (en cliquant sur « Actualiser »), afficher son contenu (« Afficher ») ou le supprimer (« Supprimer ») :\\

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-93ab7483abdd323a9ef1ea679bb0cc71c40762eb%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/container/javascript-block.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
