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

Fungsi perpustakaan tersedia untuk skri Node.js p kenari menggunakan Playwright

Bagian ini menjelaskan fungsi pustaka yang tersedia untuk skrip canary menggunakan runtime Node.js Playwright.

meluncurkan

Fungsi ini meluncurkan browser Chromium menggunakan fungsi peluncuran Playwright, dan mengembalikan objek browser. Ini mendekompresi binari browser dan meluncurkan browser Chromium dengan menggunakan opsi default yang cocok untuk browser tanpa kepala. Untuk informasi selengkapnya tentang launch fungsi ini, lihat launch dalam dokumentasi Dramawan.

Penggunaan

const browser = await synthetics.launch();

Argumen

optionsopsi (opsional) adalah serangkaian opsi yang dapat dikonfigurasi untuk browser.

Pengembalian

Jan <Browser> ji dimana Browser adalah contoh browser Playwright.

Jika fungsi ini dipanggil lagi, browser yang dibuka sebelumnya ditutup sebelum memulai browser baru. Anda dapat mengganti parameter peluncuran yang digunakan oleh CloudWatch Synthetics, dan meneruskan parameter tambahan saat meluncurkan browser. Misalnya, cuplikan kode berikut meluncurkan browser dengan argumen default dan jalur eksekusi default, tetapi dengan viewport 800 x 600 piksel. Untuk informasi selengkapnya, lihat Opsi peluncuran Playwright di dokumentasi Playwright.

const browser = await synthetics.launch({
  defaultViewport: {
      "deviceScaleFactor": 1,
      "width": 800,
      "height": 600
}});

Anda juga dapat menambahkan atau mengganti flag Chromium yang diteruskan secara default ke browser. Misalnya, Anda dapat menonaktifkan keamanan web dengan menambahkan tanda ke --disable-web-security argumen dalam parameter peluncuran CloudWatch Synthetics:

// This function adds the --disable-web-security flag to the launch parameters
const defaultOptions = await synthetics.getDefaultLaunchOptions();
const launchArgs = [...defaultOptions.args, '--disable-web-security'];
const browser = await synthetics.launch({
    args: launchArgs
  });

Halaman baru

newPage()Fungsi ini membuat dan mengembalikan halaman Playwright baru. Synthetics secara otomatis mengatur koneksi Chrome DevTools Protocol (CDP) untuk mengaktifkan tangkapan jaringan untuk pembuatan arsip HTTP (HAR).

Penggunaan

Gunakan newPage() dengan salah satu cara berikut:

1. Membuat halaman baru dalam konteks browser baru:

const page = await synthetics.newPage(browser);

2. Membuat halaman baru dalam konteks browser tertentu:

// Create a new browser context
const browserContext = await browser.newContext();

// Create a new page in the specified browser context
const page = await synthetics.newPage(browserContext)

Argumen

Menerima instance Browser Playwright atau instance Playwright BrowserContext.

Pengembalian

Jan <Page>ji di mana Page adalah contoh Halaman Dramawan.

tutup

Menutup browser yang sedang dibuka.

Penggunaan

await synthetics.close();

Disarankan untuk menutup browser di finally blok skrip Anda.

Argumen

Tidak ada

Pengembalian

Mengembalikan <void>Janji yang digunakan oleh fungsi peluncuran Synthetics untuk meluncurkan browser.

dapatkan DefaultLaunchOptions

getDefaultLaunchOptions()Fungsi mengembalikan opsi peluncuran browser yang digunakan oleh CloudWatch Synthetics.

Penggunaan

const defaultOptions = await synthetics.getDefaultLaunchOptions();

Argumen

Tidak ada

Pengembalian

Mengembalikan opsi peluncuran Playwright yang digunakan oleh launch fungsi Synthetics untuk meluncurkan browser.

JalankanStep

executeStepFungsi ini digunakan untuk menjalankan langkah dalam skrip Synthetics. Di CloudWatch Synthetics, langkah Synthetics adalah cara untuk memecah skrip kenari Anda menjadi serangkaian tindakan yang jelas, memungkinkan Anda memantau berbagai bagian perjalanan aplikasi Anda secara terpisah. Untuk setiap langkah, CloudWatch Synthetics melakukan hal berikut:

Penggunaan

await synthetics.executeStep("mystepname", async function () {
  await page.goto(url, { waitUntil: 'load', timeout: 30000 });
}

Argumen

Pengembalian

Mengembalikan Promise yang diselesaikan dengan nilai yang dikembalikan oleh functionToExecute fungsi. Untuk contoh skrip, lihat Kode sampel untuk skrip canary dalam panduan ini.