Pilih preferensi cookie Anda

Kami menggunakan cookie penting serta alat serupa yang diperlukan untuk menyediakan situs dan layanan. Kami menggunakan cookie performa untuk mengumpulkan statistik anonim sehingga kami dapat memahami cara pelanggan menggunakan situs dan melakukan perbaikan. Cookie penting tidak dapat dinonaktifkan, tetapi Anda dapat mengklik “Kustom” atau “Tolak” untuk menolak cookie performa.

Jika Anda setuju, AWS dan pihak ketiga yang disetujui juga akan menggunakan cookie untuk menyediakan fitur situs yang berguna, mengingat preferensi Anda, dan menampilkan konten yang relevan, termasuk iklan yang relevan. Untuk menerima atau menolak semua cookie yang tidak penting, klik “Terima” atau “Tolak”. Untuk membuat pilihan yang lebih detail, klik “Kustomisasi”.

Membangun fungsi Lambda dengan Node.js

Mode fokus
Membangun fungsi Lambda dengan Node.js - AWS Lambda

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Anda dapat menjalankan JavaScript kode dengan Node.js di AWS Lambda. Lambda menyediakan runtime untuk Node.js yang menjalankan kode Anda untuk memproses peristiwa. Kode Anda berjalan di lingkungan yang menyertakan AWS SDK for JavaScript, dengan kredensi dari peran AWS Identity and Access Management (IAM) yang Anda kelola. Untuk mempelajari lebih lanjut tentang versi SDK yang disertakan dengan runtime Node.js, lihat. Versi SDK yang disertakan Runtime

Lambda mendukung runtime Node.js berikut.

Nama Pengidentifikasi Sistem operasi Tanggal pengusangan Buat fungsi blok Pembaruan fungsi blok

Node.js 22

nodejs22.x

Amazon Linux 2023

30 Apr 2027

1 Jun 2027

1 Jul 2027

Node.js 20

nodejs20.x

Amazon Linux 2023

30 Apr 2026

1 Jun 2026

1 Jul 2026

Node.js 18

nodejs18.x

Amazon Linux 2

1 Sep 2025

1 Okt 2025

Nov 1, 2025

Untuk membuat fungsi Node.js
  1. Buka Konsol Lambda.

  2. Pilih Buat fungsi.

  3. Konfigurasikan pengaturan berikut:

    • Nama fungsi: Masukkan nama untuk fungsi tersebut.

    • Runtime: Pilih Node.js 22.x.

  4. Pilih Buat fungsi.

Konsol membuat fungsi Lambda dengan satu file sumber bernama index.mjs. Anda dapat mengedit file ini dan menambahkan lebih banyak file di editor kode bawaan. Di bagian DEPLOY, pilih Deploy untuk memperbarui kode fungsi Anda. Kemudian, untuk menjalankan kode Anda, pilih Create test event di bagian TEST EVENTS.

File index.mjs mengekspor fungsi bernama handler yang menerima objek peristiwa dan objek konteks. Ini adalah fungsi handler yang dipanggil Lambda saat fungsi tersebut dipanggil. Waktu habis fungsi Node.js mendapatkan peristiwa invokasi dari Lambda dan meneruskannya ke handler. Dalam konfigurasi fungsi, nilai handler adalah index.handler.

Saat Anda menyimpan kode fungsi, konsol Lambda membuat paket penyebaran arsip file.zip. Saat Anda mengembangkan kode fungsi di luar konsol (menggunakan IDE), Anda perlu membuat paket penerapan untuk mengunggah kode Anda ke fungsi Lambda.

Runtime fungsi meneruskan objek konteks ke handler, selain peristiwa invokasi. Objek konteks berisi informasi tambahan tentang lingkungan invokasi, fungsi, dan eksekusi. Informasi selengkapnya tersedia dari variabel lingkungan.

Fungsi Lambda Anda dilengkapi dengan grup CloudWatch log Log. Runtime fungsi mengirimkan detail tentang setiap invokasi ke CloudWatch Logs. Detail tersebut menyampaikan log yang dihasilkan fungsi Anda selama invokasi. Jika fungsi mengembalikan kesalahan, Lambda memformat kesalahan dan mengembalikannya ke pemanggil.

Inisialisasi Node.js

Node.js memiliki model loop peristiwa unik yang menyebabkan perilaku inisialisasi berbeda dari runtime lainnya. Secara khusus, Node.js menggunakan model I/O non-pemblokiran yang mendukung operasi asinkron. Model ini memungkinkan Node.js bekerja secara efisien untuk sebagian besar beban kerja. Misalnya, jika fungsi Node.js membuat panggilan jaringan, permintaan tersebut dapat ditetapkan sebagai operasi asinkron dan ditempatkan ke dalam antrean panggilan balik. Fungsi ini dapat terus memproses operasi lain dalam tumpukan panggilan utama tanpa diblokir dengan menunggu panggilan jaringan kembali. Setelah panggilan jaringan selesai, callback dijalankan dan kemudian dihapus dari antrian callback.

Beberapa tugas inisialisasi dapat berjalan secara asinkron. Tugas asinkron ini tidak dijamin untuk menyelesaikan eksekusi sebelum pemanggilan. Misalnya, kode yang membuat panggilan jaringan untuk mengambil parameter dari AWS Parameter Store mungkin tidak lengkap pada saat Lambda menjalankan fungsi handler. Akibatnya, variabel mungkin nol selama pemanggilan. Untuk menghindari hal ini, pastikan bahwa variabel dan kode asinkron lainnya sepenuhnya diinisialisasi sebelum melanjutkan dengan logika bisnis inti fungsi lainnya.

Atau, Anda dapat menunjuk kode fungsi Anda sebagai modul ES, memungkinkan Anda untuk menggunakan await di tingkat atas file, di luar lingkup penangan fungsi Anda. Saat Anda melakukannya awaitPromise, kode inisialisasi asinkron selesai sebelum pemanggilan handler, memaksimalkan efektivitas konkurensi yang disediakan dalam mengurangi latensi start dingin. Untuk informasi selengkapnya dan contoh, lihat Menggunakan modul ES Node.js dan menunggu tingkat atas. AWS Lambda

Menunjuk penangan fungsi sebagai modul ES

Secara default, Lambda memperlakukan file dengan .js akhiran sebagai modul CommonJS. Secara opsional, Anda dapat menunjuk kode Anda sebagai modul ES. Anda dapat melakukan ini dengan dua cara: menentukan type as module dalam package.json file fungsi, atau dengan menggunakan ekstensi nama .mjs file. Pada pendekatan pertama, kode fungsi Anda memperlakukan semua .js file sebagai modul ES, sedangkan dalam skenario kedua, hanya file yang Anda tentukan .mjs adalah modul ES. Anda dapat mencampur modul ES dan modul CommonJS dengan menamainya .mjs dan .cjs masing-masing, karena .mjs file selalu modul ES dan .cjs file selalu modul CommonJS.

Lambda mencari folder dalam variabel NODE_PATH lingkungan saat memuat modul ES. Anda dapat memuat AWS SDK yang disertakan dalam runtime menggunakan pernyataan modul import ES. Anda juga dapat memuat modul ES dari lapisan.

Versi SDK yang disertakan Runtime

Versi AWS SDK yang disertakan dalam runtime Node.js bergantung pada versi runtime dan versi Anda. Wilayah AWS Untuk menemukan versi SDK yang disertakan dalam runtime yang Anda gunakan, buat fungsi Lambda dengan kode berikut.

contoh index.mjs
import packageJson from '@aws-sdk/client-s3/package.json' with { type: 'json' }; export const handler = async () => ({ version: packageJson.version });

Ini mengembalikan respons dalam format berikut:

{ "version": "3.632.0" }

Menggunakan keep-alive untuk koneksi TCP

Agen HTTP/HTTPS Node.js default membuat koneksi TCP baru untuk setiap permintaan baru. Untuk menghindari biaya pembuatan koneksi baru, keep-alive diaktifkan secara default di dan nodejs18.x kemudian runtime Lambda. Keep-alive dapat mengurangi waktu permintaan untuk fungsi Lambda yang membuat beberapa panggilan API menggunakan SDK.

Untuk menonaktifkan keep-alive, lihat Menggunakan kembali koneksi dengan keep-alive di Node.js di SDK for 3.x Developer Guide.AWS JavaScript Untuk informasi selengkapnya tentang penggunaan keep-alive, lihat HTTP keep-alive aktif secara default di AWS SDK modular untuk di Blog Alat Pengembang. JavaScript AWS

Pemuatan sertifikat CA

Untuk versi runtime Node.js hingga Node.js 18, Lambda secara otomatis memuat sertifikat CA (otoritas sertifikat) khusus Amazon untuk memudahkan Anda membuat fungsi yang berinteraksi dengan yang lain. Layanan AWS Misalnya, Lambda menyertakan sertifikat Amazon RDS yang diperlukan untuk memvalidasi sertifikat identitas server yang diinstal pada database Amazon RDS Anda. Perilaku ini dapat memiliki dampak kinerja selama start dingin.

Dimulai dengan Node.js 20, Lambda tidak lagi memuat sertifikat CA tambahan secara default. Runtime Node.js 20 berisi file sertifikat dengan semua sertifikat Amazon CA terletak di/var/runtime/ca-cert.pem. Untuk memulihkan perilaku yang sama dari Node.js 18 dan runtime sebelumnya, setel variabel NODE_EXTRA_CA_CERTS lingkungan ke/var/runtime/ca-cert.pem.

Untuk kinerja yang optimal, kami sarankan untuk menggabungkan hanya sertifikat yang Anda butuhkan dengan paket penerapan Anda dan memuatnya melalui variabel NODE_EXTRA_CA_CERTS lingkungan. File sertifikat harus terdiri dari satu atau lebih root tepercaya atau sertifikat CA perantara dalam format PEM. Misalnya, untuk RDS, sertakan sertifikat yang diperlukan di samping kode Anda sebagaicertificates/rds.pem. Kemudian, muat sertifikat dengan menyetel NODE_EXTRA_CA_CERTS ke/var/task/certificates/rds.pem.

PrivasiSyarat situsPreferensi cookie
© 2025, Amazon Web Services, Inc. atau afiliasinya. Semua hak dilindungi undang-undang.