Playwright MCP

Tambahkan melalui layar pengaturan ekstensi VS Code Amp atau dengan memperbarui file settings.json Anda:

"amp.mcpServers": {
  "playwright": {
    "command": "npx",
    "args": [
      "@playwright/mcp@latest"
    ]
  }
}

Pengaturan Amp CLI:

Tambahkan melalui perintah amp mcp add di bawah ini

amp mcp add playwright -- npx @playwright/mcp@latest

Tambahkan melalui pengaturan Antigravity atau dengan memperbarui file konfigurasi Anda:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Gunakan CLI Claude Code untuk menambahkan server Playwright MCP:

claude mcp add playwright npx @playwright/mcp@latest

Ikuti panduan instalasi MCP, gunakan konfigurasi standar di atas.

Ikuti instruksi di bagian Mengonfigurasi Server MCP

Contoh: Pengaturan Lokal

Tambahkan berikut ini ke file cline_mcp_settings.json Anda:

{
  "mcpServers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "timeout": 30,
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ],
      "disabled": false
    }
  }
}

Gunakan CLI Codex untuk menambahkan server Playwright MCP:

codex mcp add playwright npx "@playwright/mcp@latest"

Atau, buat atau edit file konfigurasi ~/.codex/config.toml dan tambahkan:

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

Untuk informasi lebih lanjut, lihat dokumentasi MCP Codex.

Gunakan CLI Copilot untuk menambahkan server Playwright MCP secara interaktif:

/mcp add

Atau, buat atau edit file konfigurasi ~/.copilot/mcp-config.json dan tambahkan:

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Untuk informasi lebih lanjut, lihat dokumentasi CLI Copilot.

Klik tombol untuk menginstal:

Atau instal secara manual:

Buka Cursor Settings -> MCP -> Add new MCP Server. Beri nama sesuai keinginan Anda, gunakan tipe command dengan perintah npx @playwright/mcp@latest. Anda juga dapat memverifikasi konfigurasi atau menambahkan argumen seperti perintah dengan mengklik Edit.

Gunakan CLI Factory untuk menambahkan server Playwright MCP:

droid mcp add playwright "npx @playwright/mcp@latest"

Atau, ketik /mcp di dalam Factory droid untuk membuka UI interaktif untuk mengelola server MCP.

Untuk informasi lebih lanjut, lihat dokumentasi MCP Factory.

Ikuti panduan instalasi MCP, gunakan konfigurasi standar di atas.

Klik tombol untuk menginstal:

Atau instal secara manual:

Buka Advanced settings -> Extensions -> Add custom extension. Beri nama sesuai keinginan Anda, gunakan tipe STDIO, dan atur command menjadi npx @playwright/mcp. Klik "Add Extension".

Gunakan CLI Grok untuk menambahkan server Playwright MCP:

grok mcp add playwright -- npx @playwright/mcp@latest

Atau, buat atau edit file konfigurasi ~/.grok/config.toml dan tambahkan:

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

Untuk informasi lebih lanjut, lihat dokumentasi MCP Grok.

Untuk menambahkan server Playwright MCP di Junie CLI:

1. Ketik /mcp
2. Tekan Ctrl+A untuk menambahkan server MCP baru
3. Pilih Playwright dari daftar

Atau, tambahkan ke .junie/mcp/mcp.json:

{
  "mcpServers": {
    "Playwright": {
      "command": "npx",
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ]
    }
  }
}

Untuk informasi lebih lanjut, lihat dokumentasi konfigurasi MCP Junie.

Ikuti dokumentasi Server MCP. Misalnya di .kiro/settings/mcp.json:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Klik tombol untuk menginstal:

Atau instal secara manual:

Buka Program di sidebar kanan -> Install -> Edit mcp.json. Gunakan konfigurasi standar di atas.

Ikuti dokumentasi Server MCP. Misalnya di ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "playwright": {
      "type": "local",
      "command": [
        "npx",
        "@playwright/mcp@latest"
      ],
      "enabled": true
    }
  }
}

Buka panel obrolan Qodo Gen di VSCode atau IntelliJ → Connect more tools → + Add new MCP → Tempel konfigurasi standar di atas.

Klik Save.

Klik tombol untuk menginstal:

Atau instal secara manual:

Ikuti panduan instalasi MCP, gunakan konfigurasi standar di atas. Anda juga dapat menginstal server Playwright MCP menggunakan CLI VS Code:

# For VS Code
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

Setelah instalasi, server Playwright MCP akan tersedia untuk digunakan dengan agen GitHub Copilot Anda di VS Code.

Buka Settings -> AI -> Manage MCP Servers -> + Add untuk menambahkan Server MCP. Gunakan konfigurasi standar di atas.

Atau, gunakan perintah garis miring /add-mcp di prompt Warp dan tempel konfigurasi standar dari atas:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Ikuti dokumentasi MCP Windsurf. Gunakan konfigurasi standar di atas.

{
  /**
   * The browser to use.
   */
  browser?: {
    /**
     * The type of browser to use.
     */
    browserName?: 'chromium' | 'firefox' | 'webkit';

    /**
     * Keep the browser profile in memory, do not save it to disk.
     */
    isolated?: boolean;

    /**
     * Path to a user data directory for browser profile persistence.
     * Temporary directory is created by default.
     */
    userDataDir?: string;

    /**
     * Launch options passed to
     * @see https://playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context
     *
     * This is useful for settings options like `channel`, `headless`, `executablePath`, etc.
     */
    launchOptions?: playwright.LaunchOptions;

    /**
     * Context options for the browser context.
     *
     * This is useful for settings options like `viewport`.
     */
    contextOptions?: playwright.BrowserContextOptions;

    /**
     * Chrome DevTools Protocol endpoint to connect to an existing browser instance in case of Chromium family browsers.
     */
    cdpEndpoint?: string;

    /**
     * CDP headers to send with the connect request.
     */
    cdpHeaders?: Record<string, string>;

    /**
     * Timeout in milliseconds for connecting to CDP endpoint. Defaults to 30000 (30 seconds). Pass 0 to disable timeout.
     */
    cdpTimeout?: number;

    /**
     * Remote endpoint to connect to an existing Playwright server. May be a
     * WebSocket URL string, or a [ConnectOptions] object that mirrors the
     * `connectOptions` shape used by the test runner. When passed as an object,
     * `exposeNetwork`, `headers`, `slowMo`, and `timeout` are forwarded to the
     * underlying connect call.
     */
    remoteEndpoint?: string | playwright.ConnectOptions & { endpoint: string };

    /**
     * Paths to TypeScript files to add as initialization scripts for Playwright page.
     */
    initPage?: string[];

    /**
     * Paths to JavaScript files to add as initialization scripts.
     * The scripts will be evaluated in every page before any of the page's scripts.
     */
    initScript?: string[];
  },

  /**
   * Connect to a running browser instance (Edge/Chrome only). If specified, `browser`
   * config is ignored.
   * Requires the "Playwright Extension" to be installed.
   */
  extension?: boolean;

  server?: {
    /**
     * The port to listen on for SSE or MCP transport.
     */
    port?: number;

    /**
     * The host to bind the server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.
     */
    host?: string;

    /**
     * The hosts this server is allowed to serve from. Defaults to the host server is bound to.
     * This is not for CORS, but rather for the DNS rebinding protection.
     */
    allowedHosts?: string[];
  },

  /**
   * List of enabled tool capabilities. Possible values:
   *   - 'core': Core browser automation features.
   *   - 'pdf': PDF generation and manipulation.
   *   - 'vision': Coordinate-based interactions.
   *   - 'devtools': Developer tools features.
   */
  capabilities?: ToolCapability[];

  /**
   * Whether to save the Playwright session into the output directory.
   */
  saveSession?: boolean;

  /**
   * Whether to collect and expose the tools that a page registers through the
   * experimental WebMCP API. Enabled by default.
   */
  webmcp?: boolean;

  /**
   * Reuse the same browser context between all connected HTTP clients.
   */
  sharedBrowserContext?: boolean;

  /**
   * Secrets are used to replace matching plain text in the tool responses to prevent the LLM
   * from accidentally getting sensitive data. It is a convenience and not a security feature,
   * make sure to always examine information coming in and from the tool on the client.
   */
  secrets?: Record<string, string>;

  /**
   * The directory for automatically named output files, for example a screenshot taken without an
   * explicit file name. Files with an explicit name are resolved against the workspace root instead
   * and are not affected by this option.
   */
  outputDir?: string;

  /**
   * Threshold for evicting old output files, in bytes.
   */
  outputMaxSize?: number;

  console?: {
    /**
     * The level of console messages to return. Each level includes the messages of more severe levels. Defaults to "info".
     */
    level?: 'error' | 'warning' | 'info' | 'debug';
  },

  network?: {
    /**
     * List of origins to allow the browser to request. Default is to allow all. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
     *
     * Supported formats:
     * - Full origin: `https://example.com:8080` - matches only that origin
     * - Wildcard port: `http://localhost:*` - matches any port on localhost with http protocol
     */
    allowedOrigins?: string[];

    /**
     * List of origins to block the browser to request. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
     *
     * Supported formats:
     * - Full origin: `https://example.com:8080` - matches only that origin
     * - Wildcard port: `http://localhost:*` - matches any port on localhost with http protocol
     */
    blockedOrigins?: string[];
  };

  /**
   * Specify the attribute to use for test ids, defaults to "data-testid".
   */
  testIdAttribute?: string;

  timeouts?: {
    /*
     * Configures default action timeout: https://playwright.dev/docs/api/class-page#page-set-default-timeout. Defaults to 5000ms.
     */
    action?: number;

    /*
     * Configures default navigation timeout: https://playwright.dev/docs/api/class-page#page-set-default-navigation-timeout. Defaults to 60000ms.
     */
    navigation?: number;

    /**
     * Configures default expect timeout: https://playwright.dev/docs/test-timeouts#expect-timeout. Defaults to 5000ms.
     */
    expect?: number;

    /**
     * How long to wait after each action for triggered work (navigations, requests) to settle before responding. Defaults to 500ms.
     */
    settle?: number;

    /**
     * Close the browser after this many milliseconds without a tool call, and relaunch it on the next one.
     * Defaults to one hour for headless browsers Playwright launched, and to no timeout for headed or attached ones. Pass 0 to disable.
     * The CLI shuts the whole session down instead of relaunching.
     */
    idle?: number;
  };

  /**
   * Whether to send image responses to the client. Can be "allow", "omit", or "only". Defaults to "allow".
   * With "only", a response that carries an image consists of the image parts alone, without the text part.
   */
  imageResponses?: 'allow' | 'omit' | 'only';

  /**
   * How file paths are rendered in tool results. Can be "relative" to the workspace root or "absolute". Defaults to "relative".
   */
  filePaths?: 'relative' | 'absolute';

  snapshot?: {
    /**
     * When taking snapshots for responses, specifies the mode to use.
     */
    mode?: 'full' | 'none';

    /**
     * Whether to include each element's bounding box as [box=x,y,width,height] in snapshots.
     * Coordinates are viewport-relative, in CSS pixels (Element.getBoundingClientRect).
     */
    boxes?: boolean;
  };

  /**
   * allowUnrestrictedFileAccess acts as a guardrail to prevent the LLM from accidentally
   * wandering outside its intended workspace. It is a convenience defense to catch unintended
   * file access, not a secure boundary; a deliberate attempt to reach other directories can be
   * easily worked around, so always rely on client-level permissions for true security.
   */
  allowUnrestrictedFileAccess?: boolean;

  /**
   * Specify the language to use for code generation.
   */
  codegen?: 'typescript' | 'python' | 'java' | 'csharp' | 'none';
}

CATATAN: Implementasi Docker saat ini hanya mendukung chromium headless.

{
  "mcpServers": {
    "playwright": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "--pull=always", "mcr.microsoft.com/playwright/mcp"]
    }
  }
}

Atau jika Anda lebih suka menjalankan container sebagai layanan jangka panjang daripada membiarkan klien MCP yang memulainya, gunakan:

docker run -d -i --rm --init --pull=always \
  --entrypoint node \
  --name playwright \
  -p 8931:8931 \
  mcr.microsoft.com/playwright/mcp \
  /app/cli.js --headless --browser chromium --no-sandbox --port 8931 --host 0.0.0.0

Server akan mendengarkan pada port host 8931 dan dapat diakses oleh klien MCP mana pun.

Anda dapat membangun image Docker sendiri.

docker build -t mcr.microsoft.com/playwright/mcp .

import http from 'http';

import { createConnection } from '@playwright/mcp';
import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';

http.createServer(async (req, res) => {
  // ...

  // Creates a headless Playwright MCP server with SSE transport
  const connection = await createConnection({ browser: { launchOptions: { headless: true } } });
  const transport = new SSEServerTransport('/messages', res);
  await connection.connect(transport);

  // ...
});

• browser_click
  • Judul: Klik
  • Deskripsi: Melakukan klik pada halaman web
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • target (string): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
    • doubleClick (boolean, opsional): Apakah akan melakukan klik ganda alih-alih klik tunggal
    • button (string, opsional): Tombol yang akan diklik, default ke kiri
    • modifiers (array, opsional): Tombol pengubah yang akan ditekan
  • Hanya-baca: false

• browser_close
  • Judul: Tutup browser
  • Deskripsi: Menutup halaman
  • Parameter: Tidak ada
  • Hanya-baca: false

• browser_console_messages
  • Judul: Dapatkan pesan konsol
  • Deskripsi: Mengembalikan semua pesan konsol
  • Parameter:
    • level (string): Tingkat pesan konsol yang akan dikembalikan. Setiap tingkat menyertakan pesan dari tingkat yang lebih parah. Default ke "info".
    • all (boolean, opsional): Mengembalikan semua pesan konsol sejak awal sesi, bukan hanya sejak navigasi terakhir. Default ke false.
    • filename (string, opsional): Nama file untuk menyimpan pesan konsol. Nama file relatif diselesaikan terhadap root workspace. Jika tidak disediakan, pesan dikembalikan sebagai teks.
  • Hanya-baca: true

• browser_drag
  • Judul: Seret mouse
  • Deskripsi: Melakukan seret dan lepas antara dua elemen
  • Parameter:
    • startElement (string, opsional): Deskripsi elemen sumber yang dapat dibaca manusia digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • startTarget (string): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
    • endElement (string, opsional): Deskripsi elemen target yang dapat dibaca manusia digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • endTarget (string): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
  • Hanya-baca: false

• browser_drop
  • Judul: Lepaskan file atau data ke elemen
  • Deskripsi: Lepaskan file atau data berjenis MIME ke elemen, seolah-olah diseret dari luar halaman. Setidaknya salah satu dari "paths" atau "data" harus disediakan.
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • target (string): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
    • paths (array, opsional): Jalur absolut ke file yang akan dilepaskan ke elemen.
    • data (object, opsional): Data yang akan dilepaskan, sebagai peta jenis MIME ke nilai string (misalnya {"text/plain": "halo", "text/uri-list": "https://example.com"}).
  • Hanya-baca: false

• browser_emulate_media
  • Judul: Emulasikan fitur media
  • Deskripsi: Emulasikan fitur media CSS untuk halaman, misalnya beralih antara skema warna terang dan gelap. Parameter yang dihilangkan dibiarkan tidak berubah; null menghapus penimpaan.
  • Parameter:
    • colorScheme (opsional): Mengemulasikan fitur media prefers-color-scheme
    • reducedMotion (opsional): Mengemulasikan fitur media prefers-reduced-motion
    • forcedColors (opsional): Mengemulasikan fitur media forced-colors
    • contrast (opsional): Mengemulasikan fitur media prefers-contrast
    • media (opsional): Mengubah jenis media CSS halaman
  • Hanya-baca: false

• browser_evaluate
  • Judul: Evaluasi JavaScript
  • Deskripsi: Evaluasi ekspresi JavaScript pada halaman atau elemen
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • target (string, opsional): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
    • function (string): () => { /* kode / } atau (element) => { / kode */ } saat elemen disediakan
    • filename (string, opsional): Nama file untuk menyimpan hasil. Nama file relatif diselesaikan terhadap root workspace. Jika tidak disediakan, hasil dikembalikan sebagai teks.
  • Hanya-baca: false

• browser_file_upload
  • Judul: Unggah file
  • Deskripsi: Unggah satu atau beberapa file
  • Parameter:
    • paths (array, opsional): Jalur absolut ke file yang akan diunggah. Dapat berupa satu file atau beberapa file. Jika dihilangkan, pemilih file dibatalkan.
  • Hanya-baca: false

• browser_fill_form
  • Judul: Isi formulir
  • Deskripsi: Isi beberapa kolom formulir
  • Parameter:
    • fields (array): Kolom yang akan diisi
  • Hanya-baca: false

• browser_find
  • Judul: Temukan di snapshot halaman
  • Deskripsi: Cari snapshot aksesibilitas halaman saat ini untuk teks atau ekspresi reguler. Mengembalikan node snapshot yang cocok dengan beberapa baris konteks di sekitarnya (seperti cuplikan pencarian), masing-masing ditampilkan di bawah jalurnya dari akar pohon, yang lebih murah daripada menangkap seluruh snapshot saat Anda hanya perlu menemukan elemen dan ref-nya.
  • Parameter:
    • text (string, opsional): Teks biasa untuk dicari di snapshot halaman (pencocokan substring tidak peka huruf besar/kecil). Berikan teks atau regex, bukan keduanya.
    • regex (string, opsional): Ekspresi reguler untuk dicari di snapshot halaman. Pencocokan peka huruf besar/kecil secara default; bungkus pola dalam garis miring untuk menambahkan flag, misalnya "/error/i" untuk tidak peka huruf besar/kecil. Berikan teks atau regex, bukan keduanya.
    • filename (string, opsional): Simpan hasil ke file alih-alih mengembalikannya dalam respons. Nama file relatif diselesaikan terhadap root workspace.
  • Hanya-baca: true

• browser_handle_dialog
  • Judul: Tangani dialog
  • Deskripsi: Tangani dialog
  • Parameter:
    • accept (boolean): Apakah akan menerima dialog.
    • promptText (string, opsional): Teks prompt jika berupa dialog prompt.
  • Hanya-baca: false

• browser_hover
  • Judul: Arahkan mouse
  • Deskripsi: Arahkan kursor ke elemen pada halaman
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • target (string): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
  • Hanya-baca: false

• browser_navigate
  • Judul: Navigasi ke URL
  • Deskripsi: Navigasi ke URL
  • Parameter:
    • url (string): URL yang akan dinavigasi
  • Hanya-baca: false

• browser_navigate_back
  • Judul: Kembali
  • Deskripsi: Kembali ke halaman sebelumnya dalam riwayat
  • Parameter: Tidak ada
  • Hanya-baca: false

• browser_network_request
  • Judul: Tampilkan detail permintaan jaringan
  • Deskripsi: Mengembalikan detail lengkap (header dan isi) dari satu permintaan jaringan, atau satu bagian jika part diatur. Gunakan nomor dari browser_network_requests.
  • Parameter:
    • index (integer): Indeks berbasis 1 dari permintaan, seperti yang dicetak oleh browser_network_requests.
    • part (string, opsional): Hanya kembalikan bagian permintaan ini. Hilangkan untuk mengembalikan detail lengkap.
    • filename (string, opsional): Nama file untuk menyimpan hasil. Nama file relatif diselesaikan terhadap root workspace. Jika tidak disediakan, output dikembalikan sebagai teks.
  • Hanya-baca: true

• browser_network_requests
  • Judul: Daftar permintaan jaringan
  • Deskripsi: Mengembalikan daftar bernomor permintaan jaringan sejak memuat halaman. Gunakan browser_network_request dengan nomor untuk mendapatkan detail lengkap.
  • Parameter:
    • static (boolean): Apakah akan menyertakan sumber daya statis yang berhasil seperti gambar, font, skrip, dll. Default ke false.
    • filter (string, opsional): Hanya kembalikan permintaan yang URL-nya cocok dengan regexp ini (misalnya "/api/.*user").
    • filename (string, opsional): Nama file untuk menyimpan permintaan jaringan. Nama file relatif diselesaikan terhadap root workspace. Jika tidak disediakan, permintaan dikembalikan sebagai teks.
  • Hanya-baca: true

• browser_press_key
  • Judul: Tekan tombol
  • Deskripsi: Tekan tombol pada keyboard
  • Parameter:
    • key (string): Nama tombol yang akan ditekan atau karakter yang akan dihasilkan, seperti ArrowLeft atau a
  • Hanya-baca: false

• browser_resize
  • Judul: Ubah ukuran jendela browser
  • Deskripsi: Ubah ukuran jendela browser
  • Parameter:
    • width (number): Lebar jendela browser
    • height (number): Tinggi jendela browser
  • Hanya-baca: false

• browser_run_code_unsafe
  • Judul: Jalankan kode Playwright (tidak aman)
  • Deskripsi: Jalankan cuplikan kode Playwright. Tidak aman: mengeksekusi JavaScript arbitrer dalam proses server Playwright dan setara dengan RCE.
  • Parameter:
    • code (string, opsional): Fungsi JavaScript yang berisi kode Playwright untuk dieksekusi. Ini akan dipanggil dengan satu argumen, page, yang dapat Anda gunakan untuk interaksi halaman apa pun. Misalnya: async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }
    • filename (string, opsional): Muat kode dari file yang ditentukan. Nama file relatif diselesaikan terhadap root workspace. Jika kode dan nama file disediakan, kode akan diabaikan.
  • Hanya-baca: false

• browser_select_option
  • Judul: Pilih opsi
  • Deskripsi: Pilih opsi dalam dropdown
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • target (string): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
    • values (array): Array nilai yang akan dipilih dalam dropdown. Ini bisa berupa satu nilai atau beberapa nilai.
  • Hanya-baca: false

• browser_snapshot
  • Judul: Snapshot halaman
  • Deskripsi: Mengambil snapshot aksesibilitas dari halaman saat ini, ini lebih baik daripada screenshot
  • Parameter:
    • target (string, opsional): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
    • filename (string, opsional): Simpan snapshot ke file alih-alih mengembalikannya dalam respons. Nama file relatif diselesaikan terhadap root workspace.
    • depth (number, opsional): Batasi kedalaman pohon snapshot
    • boxes (boolean, opsional): Sertakan kotak pembatas setiap elemen sebagai [box=x,y,width,height] dalam snapshot. Koordinat relatif terhadap viewport, dalam piksel CSS (Element.getBoundingClientRect)
  • Hanya-baca: true

• browser_take_screenshot
  • Judul: Ambil screenshot
  • Deskripsi: Ambil screenshot dari halaman saat ini. Anda tidak dapat melakukan tindakan berdasarkan screenshot, gunakan browser_snapshot untuk tindakan.
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • target (string, opsional): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
    • type (string, opsional): Format gambar untuk screenshot. Jika tidak diatur, disimpulkan dari ekstensi nama file, jika tidak png.
    • filename (string, opsional): Nama file untuk menyimpan screenshot. Nama file relatif diselesaikan terhadap root workspace. Jika tidak ditentukan, screenshot disimpan ke direktori output sebagai page-{timestamp}.{png|jpeg|webp}.
    • fullPage (boolean, opsional): Jika true, mengambil screenshot dari seluruh halaman yang dapat digulir, alih-alih viewport yang terlihat saat ini. Tidak dapat digunakan dengan screenshot elemen.
    • scale (string): Skala resolusi gambar. "css" menghasilkan screenshot berukuran dalam piksel CSS (lebih kecil, konsisten di seluruh perangkat). "device" menghasilkan screenshot resolusi tinggi menggunakan piksel perangkat (lebih besar, memperhitungkan rasio piksel perangkat). Default adalah css.
  • Hanya-baca: true

• browser_type
  • Judul: Ketik teks
  • Deskripsi: Ketik teks ke elemen yang dapat diedit
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • target (string): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
    • text (string): Teks untuk diketik ke elemen
    • submit (boolean, opsional): Apakah akan mengirimkan teks yang dimasukkan (tekan Enter setelahnya)
    • slowly (boolean, opsional): Apakah akan mengetik satu karakter pada satu waktu. Berguna untuk memicu penangan tombol di halaman. Secara default seluruh teks diisi sekaligus.
  • Hanya-baca: false

• browser_wait_for
  • Judul: Tunggu
  • Deskripsi: Tunggu teks muncul atau hilang atau waktu tertentu berlalu
  • Parameter:
    • time (number, opsional): Waktu tunggu dalam detik, paling banyak 30
    • text (string, opsional): Teks yang ditunggu
    • textGone (string, opsional): Teks yang ditunggu untuk hilang
  • Hanya-baca: false

• browser_tabs
  • Judul: Kelola tab
  • Deskripsi: Daftar, buat, tutup, atau pilih tab browser.
  • Parameter:
    • action (string): Operasi yang akan dilakukan
    • index (number, opsional): Indeks tab, digunakan untuk menutup/memilih. Jika dihilangkan untuk menutup, tab saat ini ditutup.
    • url (string, opsional): URL untuk dinavigasi di tab baru, digunakan untuk baru.
  • Hanya-baca: false

• browser_get_config
  • Judul: Dapatkan konfigurasi
  • Deskripsi: Dapatkan konfigurasi akhir yang diselesaikan setelah menggabungkan opsi CLI, variabel lingkungan, dan file konfigurasi.
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_network_state_set
  • Judul: Atur status jaringan
  • Deskripsi: Mengatur status jaringan browser menjadi online atau offline. Saat offline, semua permintaan jaringan akan gagal.
  • Parameter:
    • state (string): Atur ke "offline" untuk mensimulasikan mode offline, "online" untuk memulihkan konektivitas jaringan
  • Hanya-baca: false

• browser_route
  • Judul: Mock permintaan jaringan
  • Deskripsi: Atur rute untuk mock permintaan jaringan yang cocok dengan pola URL
  • Parameter:
    • pattern (string): Pola URL untuk dicocokkan (mis., "/api/users", "/*.{png,jpg}")
    • status (number, opsional): Kode status HTTP untuk dikembalikan (default: 200)
    • body (string, opsional): Isi respons (teks atau string JSON)
    • contentType (string, opsional): Header Content-Type (mis., "application/json", "text/html")
    • headers (array, opsional): Header untuk ditambahkan dalam format "Nama: Nilai"
    • removeHeaders (string, opsional): Daftar nama header yang dipisahkan koma untuk dihapus dari permintaan
  • Hanya-baca: false

• browser_route_list
  • Judul: Daftar rute jaringan
  • Deskripsi: Daftar semua rute jaringan aktif
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_unroute
  • Judul: Hapus rute jaringan
  • Deskripsi: Hapus rute jaringan yang cocok dengan pola (atau semua rute jika tidak ada pola yang ditentukan)
  • Parameter:
    • pattern (string, opsional): Pola URL untuk dihapus rutenya (hilangkan untuk menghapus semua rute)
  • Hanya-baca: false

• browser_cookie_clear
  • Judul: Hapus cookie
  • Deskripsi: Hapus semua cookie
  • Parameter: Tidak ada
  • Hanya-baca: false

• browser_cookie_delete
  • Judul: Hapus cookie
  • Deskripsi: Hapus cookie tertentu
  • Parameter:
    • name (string): Nama cookie yang akan dihapus
  • Hanya-baca: false

• browser_cookie_get
  • Judul: Dapatkan cookie
  • Deskripsi: Dapatkan cookie tertentu berdasarkan nama
  • Parameter:
    • name (string): Nama cookie yang akan didapatkan
  • Hanya-baca: true

• browser_cookie_list
  • Judul: Daftar cookie
  • Deskripsi: Daftar semua cookie (opsional difilter berdasarkan domain/path)
  • Parameter:
    • domain (string, opsional): Filter cookie berdasarkan domain
    • path (string, opsional): Filter cookie berdasarkan path
  • Hanya-baca: true

• browser_cookie_set
  • Judul: Atur cookie
  • Deskripsi: Atur cookie dengan flag opsional (domain, path, expires, httpOnly, secure, sameSite)
  • Parameter:
    • name (string): Nama cookie
    • value (string): Nilai cookie
    • domain (string, opsional): Domain cookie
    • path (string, opsional): Path cookie
    • expires (number, opsional): Kedaluwarsa cookie sebagai timestamp Unix
    • httpOnly (boolean, opsional): Apakah cookie hanya HTTP
    • secure (boolean, opsional): Apakah cookie aman
    • sameSite (string, opsional): Atribut SameSite cookie
  • Hanya-baca: false

• browser_localstorage_clear
  • Judul: Hapus localStorage
  • Deskripsi: Hapus semua localStorage
  • Parameter: Tidak ada
  • Hanya-baca: false

• browser_localstorage_delete
  • Judul: Hapus item localStorage
  • Deskripsi: Hapus item localStorage
  • Parameter:
    • key (string): Kunci yang akan dihapus
  • Hanya-baca: false

• browser_localstorage_get
  • Judul: Dapatkan item localStorage
  • Deskripsi: Dapatkan item localStorage berdasarkan kunci
  • Parameter:
    • key (string): Kunci yang akan didapatkan
  • Hanya-baca: true

• browser_localstorage_list
  • Judul: Daftar localStorage
  • Deskripsi: Daftar semua pasangan kunci-nilai localStorage
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_localstorage_set
  • Judul: Atur item localStorage
  • Deskripsi: Atur item localStorage
  • Parameter:
    • key (string): Kunci yang akan diatur
    • value (string): Nilai yang akan diatur
  • Hanya-baca: false

• browser_sessionstorage_clear
  • Judul: Hapus sessionStorage
  • Deskripsi: Hapus semua sessionStorage
  • Parameter: Tidak ada
  • Hanya-baca: false

• browser_sessionstorage_delete
  • Judul: Hapus item sessionStorage
  • Deskripsi: Hapus item sessionStorage
  • Parameter:
    • key (string): Kunci yang akan dihapus
  • Hanya-baca: false

• browser_sessionstorage_get
  • Judul: Dapatkan item sessionStorage
  • Deskripsi: Dapatkan item sessionStorage berdasarkan kunci
  • Parameter:
    • key (string): Kunci yang akan didapatkan
  • Hanya-baca: true

• browser_sessionstorage_list
  • Judul: Daftar sessionStorage
  • Deskripsi: Daftar semua pasangan kunci-nilai sessionStorage
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_sessionstorage_set
  • Judul: Atur item sessionStorage
  • Deskripsi: Atur item sessionStorage
  • Parameter:
    • key (string): Kunci yang akan diatur
    • value (string): Nilai yang akan diatur
  • Hanya-baca: false

• browser_set_storage_state
  • Judul: Pulihkan status penyimpanan
  • Deskripsi: Pulihkan status penyimpanan (cookie, penyimpanan lokal) dari file. Ini menghapus cookie dan penyimpanan lokal yang ada sebelum memulihkan.
  • Parameter:
    • filename (string): Path ke file status penyimpanan untuk dipulihkan. Nama file relatif diselesaikan terhadap root workspace.
  • Hanya-baca: false

• browser_storage_state
  • Judul: Simpan status penyimpanan
  • Deskripsi: Simpan status penyimpanan (cookie, penyimpanan lokal) ke file untuk digunakan kembali nanti
  • Parameter:
    • filename (string, opsional): Nama file untuk menyimpan status penyimpanan. Nama file relatif diselesaikan terhadap root workspace. Jika tidak ditentukan, status penyimpanan disimpan ke direktori output sebagai storage-state-{timestamp}.json.
  • Hanya-baca: true

• browser_annotate
  • Judul: Anotasi halaman saat ini
  • Deskripsi: Buka Playwright Dashboard dalam mode anotasi untuk halaman saat ini dan tunggu pengguna menggambar anotasi. Mengembalikan screenshot beranotasi, snapshot ARIA, dan daftar anotasi.
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_hide_highlight
  • Judul: Sembunyikan sorotan elemen
  • Deskripsi: Hapus overlay sorotan yang sebelumnya ditambahkan untuk elemen.
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia digunakan saat menambahkan sorotan; harus cocok dengan nilai yang diteruskan ke browser_highlight.
    • target (string, opsional): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
  • Hanya-baca: true

• browser_highlight
  • Judul: Sorot elemen
  • Deskripsi: Tampilkan overlay sorotan persisten di sekitar elemen pada halaman.
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia yang digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • target (string): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
    • style (string, opsional): CSS inline tambahan yang diterapkan pada overlay sorotan, misalnya "outline: 2px dashed red".
  • Hanya-baca: true

• browser_resume
  • Judul: Lanjutkan eksekusi skrip yang dijeda
  • Deskripsi: Lanjutkan eksekusi skrip setelah dijeda. Ketika dipanggil dengan step diatur ke true, eksekusi akan berhenti lagi sebelum aksi berikutnya.
  • Parameter:
    • step (boolean, opsional): Ketika true, eksekusi akan berhenti lagi sebelum aksi berikutnya, memungkinkan debugging langkah demi langkah.
    • location (string, opsional): Jeda eksekusi pada : tertentu, misalnya "example.spec.ts:42".
  • Hanya-baca: false

• browser_start_recording
  • Judul: Mulai merekam aksi pengguna
  • Deskripsi: Mulai merekam aksi yang dilakukan pengguna di browser sebagai kode Playwright. Gunakan ini ketika pengguna ingin mendemonstrasikan alur secara manual. Panggil browser_stop_recording ketika pengguna mengatakan selesai untuk mengambil aksi yang direkam.
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_start_tracing
  • Judul: Mulai penelusuran
  • Deskripsi: Mulai perekaman penelusuran
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_start_video
  • Judul: Mulai video
  • Deskripsi: Mulai perekaman video
  • Parameter:
    • filename (string, opsional): Nama file untuk menyimpan video. Nama file relatif diselesaikan terhadap akar ruang kerja. Jika tidak ditentukan, video disimpan ke direktori keluaran sebagai video-{timestamp}.webm.
    • size (object, opsional): Ukuran video
    • fps (number, opsional): Kecepatan bingkai video dalam bingkai per detik, defaultnya 25
    • cursor (boolean, opsional): Render kursor mouse animasi yang bergerak ke setiap titik aksi. Mengatur tempo aksi sebesar 800ms sehingga kursor memiliki waktu untuk bergerak.
  • Hanya-baca: true

• browser_stop_recording
  • Judul: Berhenti merekam aksi pengguna
  • Deskripsi: Hentikan perekaman yang dimulai dengan browser_start_recording dan kembalikan aksi yang direkam sebagai kode Playwright.
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_stop_tracing
  • Judul: Berhenti menelusuri
  • Deskripsi: Hentikan perekaman penelusuran
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_stop_video
  • Judul: Hentikan video
  • Deskripsi: Hentikan perekaman video
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_video_chapter
  • Judul: Bab video
  • Deskripsi: Tambahkan penanda bab ke perekaman video. Menampilkan kartu bab layar penuh dengan latar belakang buram.
  • Parameter:
    • title (string): Judul bab
    • description (string, opsional): Deskripsi bab
    • duration (number, opsional): Durasi dalam milidetik untuk menampilkan kartu bab
  • Hanya-baca: true

• browser_video_hide_actions
  • Judul: Sembunyikan overlay aksi
  • Deskripsi: Berhenti memberi anotasi pada aksi yang dilakukan di halaman.
  • Parameter: Tidak ada
  • Hanya-baca: true

• browser_video_show_actions
  • Judul: Tampilkan overlay aksi
  • Deskripsi: Beri anotasi pada aksi berikutnya yang dilakukan di halaman dengan callout yang menyebutkan nama aksi dan, ketika diberi gaya, menandai titik aksi dan menyorot elemen target. Berguna saat merekam video atau screencasting.
  • Parameter:
    • duration (number, opsional): Berapa lama setiap anotasi aksi tetap di layar, dalam milidetik. Defaultnya 500.
    • position (string, opsional): Di mana menempatkan judul aksi relatif terhadap halaman. Defaultnya kanan-atas.
    • cursor (string, opsional): Dekorasi kursor untuk aksi penunjuk. "pointer" (default) menganimasikan penunjuk mouse dari titik aksi sebelumnya ke titik berikutnya; "none" menonaktifkan dekorasi kursor.
    • style (object, opsional): Gaya dari dekorasi aksi.
  • Hanya-baca: true

• browser_mouse_click_xy
  • Judul: Klik
  • Deskripsi: Klik tombol mouse pada posisi tertentu
  • Parameter:
    • x (number): Koordinat X
    • y (number): Koordinat Y
    • button (string, opsional): Tombol untuk diklik, defaultnya kiri
    • clickCount (number, opsional): Jumlah klik, defaultnya 1
    • delay (number, opsional): Waktu tunggu antara mouse down dan mouse up dalam milidetik, defaultnya 0
  • Hanya-baca: false

• browser_mouse_down
  • Judul: Tekan mouse down
  • Deskripsi: Tekan mouse down
  • Parameter:
    • button (string, opsional): Tombol untuk ditekan, defaultnya kiri
  • Hanya-baca: false

• browser_mouse_drag_xy
  • Judul: Seret mouse
  • Deskripsi: Seret tombol mouse kiri ke posisi tertentu
  • Parameter:
    • startX (number): Koordinat X awal
    • startY (number): Koordinat Y awal
    • endX (number): Koordinat X akhir
    • endY (number): Koordinat Y akhir
  • Hanya-baca: false

• browser_mouse_move_xy
  • Judul: Gerakkan mouse
  • Deskripsi: Gerakkan mouse ke posisi tertentu
  • Parameter:
    • x (number): Koordinat X
    • y (number): Koordinat Y
  • Hanya-baca: false

• browser_mouse_up
  • Judul: Tekan mouse up
  • Deskripsi: Tekan mouse up
  • Parameter:
    • button (string, opsional): Tombol untuk ditekan, defaultnya kiri
  • Hanya-baca: false

• browser_mouse_wheel
  • Judul: Gulir roda mouse
  • Deskripsi: Gulir roda mouse
  • Parameter:
    • deltaX (number): Delta X
    • deltaY (number): Delta Y
  • Hanya-baca: false

• browser_pdf_save
  • Judul: Simpan sebagai PDF
  • Deskripsi: Simpan halaman sebagai PDF
  • Parameter:
    • filename (string, opsional): Nama file untuk menyimpan pdf. Nama file relatif diselesaikan terhadap akar ruang kerja. Jika tidak ditentukan, pdf disimpan ke direktori keluaran sebagai page-{timestamp}.pdf.
  • Hanya-baca: true

• browser_generate_locator
  • Judul: Buat locator untuk elemen
  • Deskripsi: Hasilkan locator untuk elemen yang diberikan untuk digunakan dalam pengujian
  • Parameter:
    • element (string, opsional): Deskripsi elemen yang dapat dibaca manusia yang digunakan untuk mendapatkan izin berinteraksi dengan elemen
    • target (string): Referensi elemen target yang tepat dari snapshot halaman, atau pemilih elemen unik
  • Hanya-baca: true

• browser_verify_element_visible
  • Judul: Verifikasi elemen terlihat
  • Deskripsi: Verifikasi elemen terlihat di halaman
  • Parameter:
    • role (string): PERAN elemen. Dapat ditemukan di snapshot seperti ini: - {ROLE} "Accessible Name":
    • accessibleName (string): NAMA_AKSESIBEL elemen. Dapat ditemukan di snapshot seperti ini: - role "{ACCESSIBLE_NAME}"
  • Hanya-baca: false

• browser_verify_list_visible
  • Judul: Verifikasi daftar terlihat
  • Deskripsi: Verifikasi daftar terlihat di halaman
  • Parameter:
    • element (string): Deskripsi daftar yang dapat dibaca manusia
    • target (string): Referensi elemen target yang tepat yang menunjuk ke daftar
    • items (array): Item untuk diverifikasi
  • Hanya-baca: false

• browser_verify_text_visible
  • Judul: Verifikasi teks terlihat
  • Deskripsi: Verifikasi teks terlihat di halaman. Utamakan browser_verify_element_visible jika memungkinkan.
  • Parameter:
    • text (string): TEKS untuk diverifikasi. Dapat ditemukan di snapshot seperti ini: - role "Accessible Name": {TEXT} atau seperti ini: - text: {TEXT}
  • Hanya-baca: false

• browser_verify_value
  • Judul: Verifikasi nilai
  • Deskripsi: Verifikasi nilai elemen
  • Parameter:
    • type (string): Jenis elemen
    • element (string): Deskripsi elemen yang dapat dibaca manusia
    • target (string): Referensi elemen target yang tepat dari snapshot halaman
    • value (string): Nilai untuk diverifikasi. Untuk checkbox, gunakan "true" atau "false".
  • Hanya-baca: false