Exceptions
Des classes d'exception typées, utilisées dans toute la bibliothèque. Les exceptions liées à un service (Sheets, Slides, Admin SDK, réseau) dérivent de la classe de base commune Exception, pour une gestion d'erreurs homogène.
La mention New signale une classe ajoutée dans la dernière version ; Deprecated une classe dont le retrait est prévu dans une version future.
Exceptions liées à un service
Exception | Description |
|---|---|
Le service Admin SDK Directory n'est pas disponible ou n'a pas été activé pour le script. | |
Un GridRange était attendu et l'objet n'en est pas un valide : bornes absentes, inversées ou négatives. | |
Une plage était attendue et la valeur n'en est pas une. | |
Une feuille était attendue et la valeur n'en est pas une. | |
Un classeur était attendu et la valeur n'en est pas un. | |
Une présentation était attendue et la valeur n'en est pas une. | |
Une diapositive était attendue et la valeur n'en est pas une, ou la diapositive demandée n'existe pas dans la présentation. |
Exceptions de base
Exception | Description |
|---|---|
La racine de la hiérarchie, dérivée d'Error. | |
Le parent de toute exception qu'un script en cours peut provoquer. | |
L'authentification a échoué : impossible d'établir qui appelle. | |
L'appelant est connu mais n'y est pas autorisé. | |
Une chaîne devait contenir quelque chose et s'est révélée null, undefined ou vide. | |
Un argument est d'un type inadapté ou hors de l'intervalle accepté. | |
L'appel est arrivé au mauvais moment : les arguments peuvent être valides, mais l'objet n'est pas dans un état qui le permet. | |
Une chaîne devait être une adresse e-mail et n'en a pas la forme. | |
Une chaîne était attendue et autre chose est arrivé. | |
null ou undefined s'est présenté là où un objet était requis. | |
Un dépôt que le script attendait n'est pas là. | |
Un service que le script attendait n'est pas là : un service avancé non activé, ou une globale jamais définie. |
Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.