Function Compute intercepte les erreurs levées par votre fonction Node.js et renvoie une réponse structurée. Cette rubrique présente les deux catégories d'erreurs que peuvent produire les fonctions Node.js et explique comment interpréter les codes d'état HTTP du service.
Types d'erreurs
Exceptions interceptées
Lorsque votre fonction lève une exception, Function Compute l'intercepte et renvoie un objet JSON comportant trois champs :
| Champ | Description |
|---|---|
errorMessage |
Le message d'erreur |
errorType |
Le nom de la classe d'erreur JavaScript |
stackTrace |
Un tableau de frames de pile d'exécution |
Modules ECMAScript
La syntaxe des modules ECMAScript nécessite Node.js 18 ou une version ultérieure. L'exemple de code prend en charge le déploiement en un clic ( nodejs-fc-err-es ).
export const handler = async (event, context) => {
throw new Error('oops');
};
Modules CommonJS
exports.handler = function(event, context, callback) {
throw new Error('oops');
};
Exemple de réponse :
{
"errorMessage": "oops",
"errorType": "Error",
"stackTrace": [
"Error: oops",
" at handler (file:///code/index.mjs:2:9)",
" at module.exports (file:///var/fc/runtime/nodejs20/bootstrap.mjs:5655:14)",
" at process.processTicksAndRejections (node:internal/process/task_queues:95:5)"
]
}
Arrêts anormaux
Si votre fonction appelle process.exit() pendant son exécution, le runtime ne peut pas capturer d'erreur structurée. Le service renvoie alors un message générique :
Modules ECMAScript
La syntaxe des modules ECMAScript nécessite Node.js 18 ou une version ultérieure.
export const handler = async (event, context) => {
process.exit(1);
};
Modules CommonJS
exports.handler = function(event, context, callback) {
process.exit(1);
};
Exemple de réponse :
{
"errorMessage": "Process exited unexpectedly before completing request (duration: 12ms, maxMemoryUsage: 0MB)"
}
Codes d'état HTTP
Une réponse 2xx ne garantit pas le succès de la fonction. Vérifiez la présence de l'en-tête de réponse X-Fc-Error-Type pour détecter les erreurs de fonction renvoyées avec un code d'état 2xx.
En cas d'échec d'un appel de fonction, Function Compute renvoie un code d'état HTTP, un corps de réponse et, pour les erreurs au niveau de la fonction, un en-tête de réponse X-Fc-Error-Type. Analysez ces signaux pour gérer les erreurs dans le code ou les transmettre aux utilisateurs finaux.
| Code d'état | Signification |
|---|---|
| 2xx | Function Compute a reçu la requête. Si la réponse inclut l'en-tête X-Fc-Error-Type, une erreur de fonction s'est produite, par exemple une exception non interceptée dans votre code. |
| 4xx (à l'exception de 429) | Le client qui a initié l'appel a envoyé une requête incorrecte. |
| 429 | La requête a été limitée (throttling). |
| 5xx | Une erreur interne s'est produite dans Function Compute, la configuration de la fonction est incorrecte ou un problème de ressource existe. |
Pour plus d'informations sur les erreurs d'appel, consultez la rubrique Configurer un mécanisme de nouvelle tentative.
FAQ
require is not defined in ES module scope
Symptôme
Lorsque le fichier d'entrée d'une fonction Node.js est chargé en tant que module ES (l'extension du fichier est .mjs, ou package.json définit "type": "module") et que le code utilise require() pour charger des modules, l'appel renvoie le code d'état HTTP 200, les en-têtes de réponse incluent X-Fc-Error-Type: InvocationError et le corps de la réponse contient l'erreur suivante :
{
"errorMessage": "require is not defined in ES module scope, you can use import instead",
"errorType": "ReferenceError",
"stackTrace": [
"ReferenceError: require is not defined in ES module scope, you can use import instead",
" at file:///code/index.mjs:1:15",
" at ModuleJob.run (node:internal/modules/esm/module_job:218:25)"
]
}
Le contenu de l'erreur varie selon le type de fichier d'entrée et l'emplacement de require() :
Si le fichier d'entrée possède une extension
.jset quepackage.jsondéfinit"type": "module",errorMessageinclut une ligne supplémentaire :This file is being treated as an ES module because it has a '.js' file extension and '/code/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.Si
require()est appelé à l'intérieur de la fonction handler plutôt qu'au niveau supérieur du module,errorMessageestrequire is not defined.
Cause
require() est la fonction de chargement du système de modules CommonJS et n'est pas disponible dans la portée des modules ES. Une fois qu'un fichier est identifié comme module ES, Node.js n'injecte pas les variables CommonJS telles que require, module et exports.
Solution
Choisissez l'une des méthodes suivantes en fonction de la structure de votre code :
Réécrivez
require()sous forme d'instructionsimportde module ES. Pour charger un module dynamiquement, utilisez l'expressionimport().Pour conserver la syntaxe
require(), renommez l'extension du fichier d'entrée en.cjs. Aucune modification de la configuration du handler de fonction n'est requise.
L'exemple suivant illustre la réécriture en module ES (fichier d'entrée index.mjs) :
// Import a Node.js built-in module and a local ES module file
import { createHash } from 'node:crypto';
import { helper } from './utils.mjs';
export const handler = async (event, context) => {
return createHash('sha256').update(helper()).digest('hex');
};
L'exemple suivant montre comment charger un module dynamiquement :
const crypto = await import('node:crypto');
L'exemple suivant illustre la syntaxe CommonJS (fichier d'entrée index.cjs) :
const crypto = require('crypto');
exports.handler = async (event, context) => {
return crypto.createHash('sha256').digest('hex');
};
Remarque : Pour charger une dépendance tierce (telle quelodash), exécutez d'abordnpm installlocalement, puis empaquetez et déployez le répertoirenode_modulesconjointement avec votre code. Dans les modules ES, vous pouvez référencer une dépendance CommonJS en utilisant un import par défaut, par exemple,import _ from 'lodash';.
Les modules ES sont pris en charge uniquement dans les runtimes Node.js 18 et versions ultérieures. Dans les runtimes Node.js 16 et versions antérieures, un fichier d'entrée .mjs n'est pas chargé et l'appel renvoie "errorMessage": "Module '/code/index.js' is missing." ainsi que "errorType": "FunctionUnhandledError: ImportModuleError".