getTriggerById

function getTriggerById(id: string): GoogleAppsScript.Script.Trigger | null;

Apps Script attribue un identifiant à la création d'un déclencheur mais n'offre aucun moyen de le retrouver : les déclencheurs du projet sont donc parcourus et comparés. Un déclencheur supprimé depuis donne null, cas que doit gérer un identifiant stocké.

Paramètres

Paramètre	Type	Description
`id`	`string`	L'identifiant du déclencheur. Il ne doit pas être vide.

Valeur de retour

GoogleAppsScript.Script.Trigger | null — le déclencheur, ou null si le projet n'en a aucun avec cet identifiant.

Exceptions

Exception	Condition
`EmptyStringException`	l'identifiant n'est pas une chaîne, ou il est vide.

Exemples

Recherche

const id = PropertiesService.getScriptProperties().getProperty("TRIGGER_ID");

const trigger = getTriggerById(id);

if (trigger !== null) {
  ScriptApp.deleteTrigger(trigger);
}

Voir aussi

Code source

src/appsscript/base/getTriggerById.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.