package.json
. I runtime di Cloud Functions Node.js in genere supportano l'installazione tramite npm o yarn . Per specificare una dipendenza per la tua funzione, aggiungila al tuo file package.json
.
In questo esempio, una dipendenza è elencata nel file package.json
:
{ "dependencies": { "escape-html": "^1.0.3" } }
La dipendenza viene quindi importata nella funzione:
javascript
const escapeHtml = require('escape-html');
// Return a greeting with the input HTML-escaped.
exports.hello = functions.https.onRequest((req, res) => {
res.send(`Hello ${escapeHtml(req.query.name || req.body.name || 'World')}!`);
});
Dattiloscritto
import * as escapeHtml from 'escape-html';
// Return a greeting with the input HTML-escaped.
export let hello = functions.https.onRequest((req, res) => {
res.send(`Hello ${escapeHtml(req.query.name || req.body.name || 'World')}!`);
}
Compresi i moduli Node.js locali
Puoi anche includere moduli Node.js locali come parte della tua funzione. Puoi ottenere ciò dichiarando il tuo modulo in package.json
usando il file:
prefix . Nell'esempio seguente, mymodule
si riferisce al nome del tuo modulo e mymoduledir
è la directory contenente il tuo modulo:
{ "dependencies": { "mymodule": "file:mymoduledir" } }
Il codice per questo modulo locale deve essere archiviato in un luogo diverso dalla cartella node_modules
all'interno della directory principale della funzione.
Passaggi aggiuntivi per TypeScript
TypeScript ti aiuta di più quando usi librerie che hanno informazioni sul tipo. Ciò consente a TypeScript di rilevare errori di sintassi e consente agli editor di fornire suggerimenti di completamento automatico migliori. Alcune librerie, come firebase-admin
e firebase-functions
, vengono fornite con definizioni TypeScript incluse.
Molte librerie non forniscono la propria definizione TypeScript. Il progetto DefinitelyTyped fornisce definizioni gestite dalla comunità per le librerie di nodi più popolari. DefinitelyTyped pubblica queste definizioni con lo stesso nome del pacchetto NPM, ma all'interno dell'organizzazione "@types". Ad esempio, puoi installare le informazioni sul tipo per la libreria uuid
con quanto segue:
npm install @types/uuid
Man mano che acquisisci familiarità con TypeScript, potresti ritrovarti a combinare entrambe le installazioni:
npm install uuid @types/uuid
Le dipendenze di tipo devono essere dello stesso tipo della dipendenza dalla libreria. Ad esempio, non dovresti salvare uuid
come dipendenza normale e @types/uuid
come dipendenza dev o dipendenza peer.
Caricamento dei moduli Node.js
Usa la funzione Node.js require()
per caricare qualsiasi modulo Node.js che hai installato. Puoi anche utilizzare la funzione require()
per importare i file locali che distribuisci insieme alla tua funzione.
import
nello stesso modo per caricare qualsiasi modulo Node.js che hai installato.Utilizzo di moduli privati
È possibile utilizzare un modulo npm privato fornendo le impostazioni per l'autenticazione con il registro in un file .npmrc
nella directory della funzione.
Moduli privati da Artifact Registry
Un repository di pacchetti Artifact Registry Node.js può ospitare moduli privati per la tua funzione. Durante la distribuzione in Cloud Functions, il processo di compilazione genererà automaticamente le credenziali Artifact Registry per l' account di servizio Cloud Build . Devi solo elencare il repository Artifact Registry nel tuo .npmrc
senza generare credenziali aggiuntive. Per esempio:
@SCOPE:registry=https://REGION_ID-npm.pkg.dev/PROJECT_ID/REPOSITORY_NAME
//REGION_ID-npm.pkg.dev/PROJECT_ID/REPOSITORY_NAME:always-auth=true
Moduli privati da altri repository
La documentazione di npm spiega come creare token di accesso di sola lettura personalizzati. Si sconsiglia di utilizzare il file .npmrc
creato nella directory home perché contiene un token di lettura-scrittura. Le autorizzazioni di scrittura non sono necessarie durante la distribuzione e potrebbero rappresentare un rischio per la sicurezza.
Non includere il file .npmrc
se non stai usando repository privati, in quanto può aumentare il tempo di distribuzione per le tue funzioni.
Formato del file
Se stai utilizzando un file .npmrc
per impostare un token di autenticazione personalizzato, dovrebbe includere la riga mostrata di seguito. Sostituisci <YOUR_AUTH_TOKEN>
con il tuo token di autenticazione fornito da NPM.
//registry.npmjs.org/:_authToken=<YOUR_AUTH_TOKEN>