Playwright MCP

Thêm qua màn hình cài đặt tiện ích mở rộng Amp VS Code hoặc bằng cách cập nhật tệp settings.json của bạn:

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

Thiết lập Amp CLI:

Thêm qua lệnh amp mcp add bên dưới

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

Thêm qua cài đặt Antigravity hoặc bằng cách cập nhật tệp cấu hình của bạn:

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

Sử dụng Claude Code CLI để thêm máy chủ Playwright MCP:

claude mcp add playwright npx @playwright/mcp@latest

Làm theo hướng dẫn cài đặt MCP, sử dụng cấu hình tiêu chuẩn ở trên.

Làm theo hướng dẫn trong phần Định cấu hình Máy chủ MCP

Ví dụ: Thiết lập cục bộ

Thêm phần sau vào tệp cline_mcp_settings.json của bạn:

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

Sử dụng Codex CLI để thêm máy chủ Playwright MCP:

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

Ngoài ra, hãy tạo hoặc chỉnh sửa tệp cấu hình ~/.codex/config.toml và thêm:

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

Để biết thêm thông tin, hãy xem tài liệu Codex MCP.

Sử dụng Copilot CLI để thêm tương tác máy chủ Playwright MCP:

/mcp add

Ngoài ra, hãy tạo hoặc chỉnh sửa tệp cấu hình ~/.copilot/mcp-config.json và thêm:

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

Để biết thêm thông tin, hãy xem tài liệu Copilot CLI.

Nhấp vào nút để cài đặt:

Hoặc cài đặt thủ công:

Đi tới Cursor Settings -> MCP -> Add new MCP Server. Đặt tên tùy thích, sử dụng loại command với lệnh npx @playwright/mcp@latest. Bạn cũng có thể xác minh cấu hình hoặc thêm các đối số dòng lệnh bằng cách nhấp vào Edit.

Sử dụng Factory CLI để thêm máy chủ Playwright MCP:

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

Ngoài ra, hãy nhập /mcp trong Factory droid để mở giao diện người dùng tương tác để quản lý máy chủ MCP.

Để biết thêm thông tin, hãy xem tài liệu Factory MCP.

Làm theo hướng dẫn cài đặt MCP, sử dụng cấu hình tiêu chuẩn ở trên.

Nhấp vào nút để cài đặt:

Hoặc cài đặt thủ công:

Đi tới Advanced settings -> Extensions -> Add custom extension. Đặt tên tùy thích, sử dụng loại STDIO và đặt command thành npx @playwright/mcp. Nhấp vào "Thêm Tiện ích mở rộng".

Sử dụng Grok CLI để thêm máy chủ Playwright MCP:

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

Ngoài ra, hãy tạo hoặc chỉnh sửa tệp cấu hình ~/.grok/config.toml và thêm:

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

Để biết thêm thông tin, hãy xem tài liệu Grok MCP.

Để thêm máy chủ Playwright MCP trong Junie CLI:

1. Nhập /mcp
2. Nhấn Ctrl+A để thêm máy chủ MCP mới
3. Chọn Playwright từ danh sách

Ngoài ra, hãy thêm vào .junie/mcp/mcp.json:

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

Để biết thêm thông tin, hãy xem tài liệu cấu hình Junie MCP.

Làm theo tài liệu về Máy chủ MCP. Ví dụ trong .kiro/settings/mcp.json:

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

Nhấp vào nút để cài đặt:

Hoặc cài đặt thủ công:

Đi tới Program trong thanh bên phải -> Install -> Edit mcp.json. Sử dụng cấu hình tiêu chuẩn ở trên.

Làm theo tài liệu về Máy chủ MCP. Ví dụ trong ~/.config/opencode/opencode.json:

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

Mở bảng trò chuyện Qodo Gen trong VSCode hoặc IntelliJ → Kết nối thêm công cụ → + Thêm MCP mới → Dán cấu hình tiêu chuẩn ở trên.

Nhấp vào Lưu.

Nhấp vào nút để cài đặt:

Hoặc cài đặt thủ công:

Làm theo hướng dẫn cài đặt MCP, sử dụng cấu hình tiêu chuẩn ở trên. Bạn cũng có thể cài đặt máy chủ Playwright MCP bằng VS Code CLI:

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

Sau khi cài đặt, máy chủ Playwright MCP sẽ sẵn sàng để sử dụng với tác nhân GitHub Copilot của bạn trong VS Code.

Đi tới Settings -> AI -> Manage MCP Servers -> + Add để thêm Máy chủ MCP. Sử dụng cấu hình tiêu chuẩn ở trên.

Ngoài ra, hãy sử dụng lệnh gạch chéo /add-mcp trong lời nhắc Warp và dán cấu hình tiêu chuẩn từ trên:

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

Làm theo tài liệu Windsurf MCP. Sử dụng cấu hình tiêu chuẩn ở trên.

{
  /**
   * 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;

  /**
   * 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 to save output files.
   */
  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;
  };

  /**
   * Whether to send image responses to the client. Can be "allow", "omit", or "auto". Defaults to "auto", which sends images if the client can display them.
   */
  imageResponses?: 'allow' | 'omit';

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

  /**
   * 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' | 'none';
}

LƯU Ý: Việc triển khai Docker hiện chỉ hỗ trợ chromium headless.

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

Hoặc nếu bạn muốn chạy container như một dịch vụ lâu dài thay vì để máy khách MCP khởi tạo nó, hãy sử dụng:

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

Máy chủ sẽ lắng nghe trên cổng máy chủ 8931 và có thể được truy cập bởi bất kỳ máy khách MCP nào.

Bạn có thể tự xây dựng hình ảnh Docker.

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);

  // ...
});

• Tiêu đề: Nhấp chuột
• Mô tả: Thực hiện thao tác nhấp chuột trên trang web
• Tham số:
  • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc dùng để xin quyền tương tác với phần tử
  • target (chuỗi): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
  • doubleClick (boolean, tùy chọn): Có thực hiện nhấp đúp thay vì nhấp đơn hay không
  • button (chuỗi, tùy chọn): Nút chuột để nhấp, mặc định là chuột trái
  • modifiers (mảng, tùy chọn): Các phím bổ trợ cần nhấn
• Chỉ đọc: false

• browser_close
  • Tiêu đề: Đóng trình duyệt
  • Mô tả: Đóng trang hiện tại
  • Tham số: Không có
  • Chỉ đọc: false

• browser_console_messages
  • Tiêu đề: Lấy thông báo từ bảng điều khiển
  • Mô tả: Trả về tất cả thông báo từ bảng điều khiển
  • Tham số:
    • level (chuỗi): Cấp độ của thông báo bảng điều khiển cần trả về. Mỗi cấp độ bao gồm các thông báo của cấp độ nghiêm trọng hơn. Mặc định là "info".
    • all (boolean, tùy chọn): Trả về tất cả thông báo bảng điều khiển kể từ đầu phiên, không chỉ từ lần điều hướng cuối cùng. Mặc định là false.
    • filename (chuỗi, tùy chọn): Tên tệp để lưu thông báo bảng điều khiển. Nếu không được cung cấp, thông báo được trả về dưới dạng văn bản.
  • Chỉ đọc: true

• browser_drag
  • Tiêu đề: Kéo chuột
  • Mô tả: Thực hiện thao tác kéo và thả giữa hai phần tử
  • Tham số:
    • startElement (chuỗi, tùy chọn): Mô tả phần tử nguồn dễ đọc dùng để xin quyền tương tác với phần tử
    • startTarget (chuỗi): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
    • endElement (chuỗi, tùy chọn): Mô tả phần tử đích dễ đọc dùng để xin quyền tương tác với phần tử
    • endTarget (chuỗi): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
  • Chỉ đọc: false

• browser_drop
  • Tiêu đề: Thả tệp hoặc dữ liệu vào phần tử
  • Mô tả: Thả tệp hoặc dữ liệu kiểu MIME vào một phần tử, như thể được kéo từ bên ngoài trang. Phải cung cấp ít nhất một trong hai "paths" hoặc "data".
  • Tham số:
    • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc dùng để xin quyền tương tác với phần tử
    • target (chuỗi): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
    • paths (mảng, tùy chọn): Đường dẫn tuyệt đối đến các tệp cần thả vào phần tử.
    • data (đối tượng, tùy chọn): Dữ liệu cần thả, dưới dạng bản đồ kiểu MIME với giá trị chuỗi (ví dụ: {"text/plain": "xin chào", "text/uri-list": "https://example.com"}).
  • Chỉ đọc: false

• browser_evaluate
  • Tiêu đề: Đánh giá JavaScript
  • Mô tả: Đánh giá biểu thức JavaScript trên trang hoặc phần tử
  • Tham số:
    • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc dùng để xin quyền tương tác với phần tử
    • target (chuỗi, tùy chọn): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
    • function (chuỗi): () => { /* mã / } hoặc (element) => { / mã */ } khi phần tử được cung cấp
    • filename (chuỗi, tùy chọn): Tên tệp để lưu kết quả. Nếu không được cung cấp, kết quả được trả về dưới dạng văn bản.
  • Chỉ đọc: false

• browser_file_upload
  • Tiêu đề: Tải tệp lên
  • Mô tả: Tải lên một hoặc nhiều tệp
  • Tham số:
    • paths (mảng, tùy chọn): Đường dẫn tuyệt đối đến các tệp cần tải lên. Có thể là một tệp hoặc nhiều tệp. Nếu bỏ qua, hộp thoại chọn tệp sẽ bị hủy.
  • Chỉ đọc: false

• browser_fill_form
  • Tiêu đề: Điền biểu mẫu
  • Mô tả: Điền nhiều trường biểu mẫu
  • Tham số:
    • fields (mảng): Các trường cần điền
  • Chỉ đọc: false

• browser_find
  • Tiêu đề: Tìm trong ảnh chụp nhanh trang
  • Mô tả: Tìm kiếm văn bản hoặc biểu thức chính quy trong ảnh chụp nhanh trợ năng của trang hiện tại. Trả về các nút ảnh chụp nhanh khớp với một vài dòng ngữ cảnh xung quanh (giống như đoạn trích tìm kiếm), mỗi nút được hiển thị dưới đường dẫn từ gốc của cây, cách này ít tốn kém hơn so với việc chụp toàn bộ ảnh chụp nhanh khi bạn chỉ cần định vị một phần tử và tham chiếu của nó.
  • Tham số:
    • text (chuỗi, tùy chọn): Văn bản thuần túy để tìm kiếm trong ảnh chụp nhanh trang (khớp chuỗi con không phân biệt chữ hoa chữ thường). Cung cấp văn bản hoặc biểu thức chính quy, không phải cả hai.
    • regex (chuỗi, tùy chọn): Biểu thức chính quy để tìm kiếm trong ảnh chụp nhanh trang. Mặc định khớp phân biệt chữ hoa chữ thường; bọc mẫu trong dấu gạch chéo để thêm cờ, ví dụ: "/error/i" cho không phân biệt chữ hoa chữ thường. Cung cấp văn bản hoặc biểu thức chính quy, không phải cả hai.
  • Chỉ đọc: true

• browser_handle_dialog
  • Tiêu đề: Xử lý hộp thoại
  • Mô tả: Xử lý một hộp thoại
  • Tham số:
    • accept (boolean): Có chấp nhận hộp thoại hay không.
    • promptText (chuỗi, tùy chọn): Văn bản của lời nhắc trong trường hợp hộp thoại nhắc.
  • Chỉ đọc: false

• browser_hover
  • Tiêu đề: Di chuột
  • Mô tả: Di chuột qua phần tử trên trang
  • Tham số:
    • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc dùng để xin quyền tương tác với phần tử
    • target (chuỗi): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
  • Chỉ đọc: false

• browser_navigate
  • Tiêu đề: Điều hướng đến URL
  • Mô tả: Điều hướng đến một URL
  • Tham số:
    • url (chuỗi): URL cần điều hướng đến
  • Chỉ đọc: false

• browser_navigate_back
  • Tiêu đề: Quay lại
  • Mô tả: Quay lại trang trước đó trong lịch sử
  • Tham số: Không có
  • Chỉ đọc: false

• browser_network_request
  • Tiêu đề: Hiển thị chi tiết yêu cầu mạng
  • Mô tả: Trả về chi tiết đầy đủ (tiêu đề và nội dung) của một yêu cầu mạng đơn lẻ, hoặc một phần đơn lẻ nếu part được đặt. Sử dụng số từ browser_network_requests.
  • Tham số:
    • index (số nguyên): Chỉ mục dựa trên 1 của yêu cầu, như được in bởi browser_network_requests.
    • part (chuỗi, tùy chọn): Chỉ trả về phần này của yêu cầu. Bỏ qua để trả về chi tiết đầy đủ.
    • filename (chuỗi, tùy chọn): Tên tệp để lưu kết quả. Nếu không được cung cấp, đầu ra được trả về dưới dạng văn bản.
  • Chỉ đọc: true

• browser_network_requests
  • Tiêu đề: Liệt kê yêu cầu mạng
  • Mô tả: Trả về danh sách được đánh số các yêu cầu mạng kể từ khi tải trang. Sử dụng browser_network_request với số để lấy chi tiết đầy đủ.
  • Tham số:
    • static (boolean): Có bao gồm các tài nguyên tĩnh thành công như hình ảnh, phông chữ, tập lệnh, v.v. hay không. Mặc định là false.
    • filter (chuỗi, tùy chọn): Chỉ trả về các yêu cầu có URL khớp với biểu thức chính quy này (ví dụ: "/api/.*user").
    • filename (chuỗi, tùy chọn): Tên tệp để lưu các yêu cầu mạng. Nếu không được cung cấp, các yêu cầu được trả về dưới dạng văn bản.
  • Chỉ đọc: true

• browser_press_key
  • Tiêu đề: Nhấn một phím
  • Mô tả: Nhấn một phím trên bàn phím
  • Tham số:
    • key (chuỗi): Tên của phím cần nhấn hoặc một ký tự để tạo, chẳng hạn như ArrowLeft hoặc a
  • Chỉ đọc: false

• browser_resize
  • Tiêu đề: Thay đổi kích thước cửa sổ trình duyệt
  • Mô tả: Thay đổi kích thước cửa sổ trình duyệt
  • Tham số:
    • width (số): Chiều rộng của cửa sổ trình duyệt
    • height (số): Chiều cao của cửa sổ trình duyệt
  • Chỉ đọc: false

• browser_run_code_unsafe
  • Tiêu đề: Chạy mã Playwright (không an toàn)
  • Mô tả: Chạy một đoạn mã Playwright. Không an toàn: thực thi JavaScript tùy ý trong tiến trình máy chủ Playwright và tương đương với RCE.
  • Tham số:
    • code (chuỗi, tùy chọn): Một hàm JavaScript chứa mã Playwright để thực thi. Nó sẽ được gọi với một đối số duy nhất, page, mà bạn có thể sử dụng cho bất kỳ tương tác trang nào. Ví dụ: async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }
    • filename (chuỗi, tùy chọn): Tải mã từ tệp được chỉ định. Nếu cả code và filename đều được cung cấp, code sẽ bị bỏ qua.
  • Chỉ đọc: false

• browser_select_option
  • Tiêu đề: Chọn tùy chọn
  • Mô tả: Chọn một tùy chọn trong danh sách thả xuống
  • Tham số:
    • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc dùng để xin quyền tương tác với phần tử
    • target (chuỗi): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
    • values (mảng): Mảng các giá trị để chọn trong danh sách thả xuống. Đây có thể là một giá trị đơn hoặc nhiều giá trị.
  • Chỉ đọc: false

• browser_snapshot
  • Tiêu đề: Ảnh chụp nhanh trang
  • Mô tả: Chụp ảnh chụp nhanh trợ năng của trang hiện tại, cách này tốt hơn ảnh chụp màn hình
  • Tham số:
    • target (chuỗi, tùy chọn): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
    • filename (chuỗi, tùy chọn): Lưu ảnh chụp nhanh vào tệp markdown thay vì trả về trong phản hồi.
    • depth (số, tùy chọn): Giới hạn độ sâu của cây ảnh chụp nhanh
    • boxes (boolean, tùy chọn): Bao gồm hộp giới hạn của mỗi phần tử dưới dạng [box=x,y,width,height] trong ảnh chụp nhanh. Tọa độ tương đối với khung nhìn, tính bằng pixel CSS (Element.getBoundingClientRect)
  • Chỉ đọc: true

• browser_take_screenshot
  • Tiêu đề: Chụp ảnh màn hình
  • Mô tả: Chụp ảnh màn hình của trang hiện tại. Bạn không thể thực hiện hành động dựa trên ảnh chụp màn hình, hãy sử dụng browser_snapshot cho các hành động.
  • Tham số:
    • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc dùng để xin quyền tương tác với phần tử
    • target (chuỗi, tùy chọn): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
    • type (chuỗi): Định dạng ảnh cho ảnh chụp màn hình. Mặc định là png.
    • filename (chuỗi, tùy chọn): Tên tệp để lưu ảnh chụp màn hình. Mặc định là page-{timestamp}.{png|jpeg} nếu không được chỉ định. Nên dùng tên tệp tương đối để ở trong thư mục đầu ra.
    • fullPage (boolean, tùy chọn): Khi true, chụp ảnh màn hình của toàn bộ trang có thể cuộn, thay vì chỉ khung nhìn hiện tại. Không thể sử dụng với ảnh chụp màn hình phần tử.
    • scale (chuỗi): Tỷ lệ độ phân giải ảnh. "css" tạo ra ảnh chụp màn hình có kích thước bằng pixel CSS (nhỏ hơn, nhất quán trên các thiết bị). "device" tạo ra ảnh chụp màn hình độ phân giải cao sử dụng pixel thiết bị (lớn hơn, tính đến tỷ lệ pixel của thiết bị). Mặc định là css.
  • Chỉ đọc: true

• browser_type
  • Tiêu đề: Nhập văn bản
  • Mô tả: Nhập văn bản vào phần tử có thể chỉnh sửa
  • Tham số:
    • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc dùng để xin quyền tương tác với phần tử
    • target (chuỗi): Tham chiếu chính xác đến phần tử đích từ ảnh chụp nhanh trang, hoặc bộ chọn phần tử duy nhất
    • text (chuỗi): Văn bản để nhập vào phần tử
    • submit (boolean, tùy chọn): Có gửi văn bản đã nhập hay không (nhấn Enter sau khi nhập)
    • slowly (boolean, tùy chọn): Có nhập từng ký tự một hay không. Hữu ích để kích hoạt trình xử lý phím trong trang. Theo mặc định, toàn bộ văn bản được điền cùng một lúc.
  • Chỉ đọc: false

• browser_wait_for
  • Tiêu đề: Chờ
  • Mô tả: Chờ văn bản xuất hiện hoặc biến mất hoặc một khoảng thời gian nhất định trôi qua
  • Tham số:
    • time (số, tùy chọn): Thời gian chờ tính bằng giây
    • text (chuỗi, tùy chọn): Văn bản cần chờ
    • textGone (chuỗi, tùy chọn): Văn bản cần chờ biến mất
  • Chỉ đọc: false

• browser_tabs
  • Tiêu đề: Quản lý tab
  • Mô tả: Liệt kê, tạo, đóng hoặc chọn một tab trình duyệt.
  • Tham số:
    • action (chuỗi): Thao tác cần thực hiện
    • index (số, tùy chọn): Chỉ mục tab, dùng cho đóng/chọn. Nếu bỏ qua khi đóng, tab hiện tại sẽ bị đóng.
    • url (chuỗi, tùy chọn): URL để điều hướng đến trong tab mới, dùng cho tạo mới.
  • Chỉ đọc: false

• browser_get_config
  • Tiêu đề: Lấy cấu hình
  • Mô tả: Lấy cấu hình đã được giải quyết cuối cùng sau khi hợp nhất các tùy chọn CLI, biến môi trường và tệp cấu hình.
  • Tham số: Không có
  • Chỉ đọc: true

• browser_network_state_set
  • Tiêu đề: Đặt trạng thái mạng
  • Mô tả: Đặt trạng thái mạng của trình duyệt thành trực tuyến hoặc ngoại tuyến. Khi ngoại tuyến, tất cả các yêu cầu mạng sẽ thất bại.
  • Tham số:
    • state (chuỗi): Đặt thành "offline" để mô phỏng chế độ ngoại tuyến, "online" để khôi phục kết nối mạng
  • Chỉ đọc: false

• browser_route
  • Tiêu đề: Giả lập yêu cầu mạng
  • Mô tả: Thiết lập một tuyến đường để giả lập các yêu cầu mạng khớp với một mẫu URL
  • Tham số:
    • pattern (chuỗi): Mẫu URL để khớp (ví dụ: "/api/users", "/*.{png,jpg}")
    • status (số, tùy chọn): Mã trạng thái HTTP để trả về (mặc định: 200)
    • body (chuỗi, tùy chọn): Nội dung phản hồi (văn bản hoặc chuỗi JSON)
    • contentType (chuỗi, tùy chọn): Tiêu đề Content-Type (ví dụ: "application/json", "text/html")
    • headers (mảng, tùy chọn): Các tiêu đề cần thêm vào theo định dạng "Tên: Giá trị"
    • removeHeaders (chuỗi, tùy chọn): Danh sách tên tiêu đề cần xóa khỏi yêu cầu, phân tách bằng dấu phẩy
  • Chỉ đọc: false

• browser_route_list
  • Tiêu đề: Liệt kê các tuyến mạng
  • Mô tả: Liệt kê tất cả các tuyến mạng đang hoạt động
  • Tham số: Không có
  • Chỉ đọc: true

• browser_unroute
  • Tiêu đề: Xóa các tuyến mạng
  • Mô tả: Xóa các tuyến mạng khớp với một mẫu (hoặc tất cả các tuyến nếu không chỉ định mẫu)
  • Tham số:
    • pattern (chuỗi, tùy chọn): Mẫu URL cần hủy tuyến (bỏ qua để xóa tất cả các tuyến)
  • Chỉ đọc: false

• browser_cookie_clear
  • Tiêu đề: Xóa cookie
  • Mô tả: Xóa tất cả cookie
  • Tham số: Không có
  • Chỉ đọc: false

• browser_cookie_delete
  • Tiêu đề: Xóa cookie
  • Mô tả: Xóa một cookie cụ thể
  • Tham số:
    • name (chuỗi): Tên cookie cần xóa
  • Chỉ đọc: false

• browser_cookie_get
  • Tiêu đề: Lấy cookie
  • Mô tả: Lấy một cookie cụ thể theo tên
  • Tham số:
    • name (chuỗi): Tên cookie cần lấy
  • Chỉ đọc: true

• browser_cookie_list
  • Tiêu đề: Liệt kê cookie
  • Mô tả: Liệt kê tất cả cookie (tùy chọn lọc theo tên miền/đường dẫn)
  • Tham số:
    • domain (chuỗi, tùy chọn): Lọc cookie theo tên miền
    • path (chuỗi, tùy chọn): Lọc cookie theo đường dẫn
  • Chỉ đọc: true

• browser_cookie_set
  • Tiêu đề: Đặt cookie
  • Mô tả: Đặt một cookie với các cờ tùy chọn (domain, path, expires, httpOnly, secure, sameSite)
  • Tham số:
    • name (chuỗi): Tên cookie
    • value (chuỗi): Giá trị cookie
    • domain (chuỗi, tùy chọn): Tên miền cookie
    • path (chuỗi, tùy chọn): Đường dẫn cookie
    • expires (số, tùy chọn): Thời gian hết hạn cookie dưới dạng dấu thời gian Unix
    • httpOnly (boolean, tùy chọn): Cookie có phải là HTTP only hay không
    • secure (boolean, tùy chọn): Cookie có phải là secure hay không
    • sameSite (chuỗi, tùy chọn): Thuộc tính SameSite của cookie
  • Chỉ đọc: false

• browser_localstorage_clear
  • Tiêu đề: Xóa localStorage
  • Mô tả: Xóa tất cả localStorage
  • Tham số: Không có
  • Chỉ đọc: false

• browser_localstorage_delete
  • Tiêu đề: Xóa mục localStorage
  • Mô tả: Xóa một mục localStorage
  • Tham số:
    • key (chuỗi): Khóa cần xóa
  • Chỉ đọc: false

• browser_localstorage_get
  • Tiêu đề: Lấy mục localStorage
  • Mô tả: Lấy một mục localStorage theo khóa
  • Tham số:
    • key (chuỗi): Khóa cần lấy
  • Chỉ đọc: true

• browser_localstorage_list
  • Tiêu đề: Liệt kê localStorage
  • Mô tả: Liệt kê tất cả các cặp khóa-giá trị localStorage
  • Tham số: Không có
  • Chỉ đọc: true

• browser_localstorage_set
  • Tiêu đề: Đặt mục localStorage
  • Mô tả: Đặt một mục localStorage
  • Tham số:
    • key (chuỗi): Khóa cần đặt
    • value (chuỗi): Giá trị cần đặt
  • Chỉ đọc: false

• browser_sessionstorage_clear
  • Tiêu đề: Xóa sessionStorage
  • Mô tả: Xóa tất cả sessionStorage
  • Tham số: Không có
  • Chỉ đọc: false

• browser_sessionstorage_delete
  • Tiêu đề: Xóa mục sessionStorage
  • Mô tả: Xóa một mục sessionStorage
  • Tham số:
    • key (chuỗi): Khóa cần xóa
  • Chỉ đọc: false

• browser_sessionstorage_get
  • Tiêu đề: Lấy mục sessionStorage
  • Mô tả: Lấy một mục sessionStorage theo khóa
  • Tham số:
    • key (chuỗi): Khóa cần lấy
  • Chỉ đọc: true

• browser_sessionstorage_list
  • Tiêu đề: Liệt kê sessionStorage
  • Mô tả: Liệt kê tất cả các cặp khóa-giá trị sessionStorage
  • Tham số: Không có
  • Chỉ đọc: true

• browser_sessionstorage_set
  • Tiêu đề: Đặt mục sessionStorage
  • Mô tả: Đặt một mục sessionStorage
  • Tham số:
    • key (chuỗi): Khóa cần đặt
    • value (chuỗi): Giá trị cần đặt
  • Chỉ đọc: false

• browser_set_storage_state
  • Tiêu đề: Khôi phục trạng thái lưu trữ
  • Mô tả: Khôi phục trạng thái lưu trữ (cookie, local storage) từ một tệp. Thao tác này sẽ xóa cookie và local storage hiện có trước khi khôi phục.
  • Tham số:
    • filename (chuỗi): Đường dẫn đến tệp trạng thái lưu trữ để khôi phục từ đó
  • Chỉ đọc: false

• browser_storage_state
  • Tiêu đề: Lưu trạng thái lưu trữ
  • Mô tả: Lưu trạng thái lưu trữ (cookie, local storage) vào một tệp để tái sử dụng sau
  • Tham số:
    • filename (chuỗi, tùy chọn): Tên tệp để lưu trạng thái lưu trữ. Mặc định là storage-state-{timestamp}.json nếu không được chỉ định.
  • Chỉ đọc: true

• browser_annotate
  • Tiêu đề: Chú thích trang hiện tại
  • Mô tả: Mở Playwright Dashboard ở chế độ chú thích cho trang hiện tại và chờ người dùng vẽ chú thích. Trả về ảnh chụp màn hình đã chú thích, ảnh chụp nhanh ARIA và danh sách các chú thích.
  • Tham số: Không có
  • Chỉ đọc: true

• browser_hide_highlight
  • Tiêu đề: Ẩn đánh dấu phần tử
  • Mô tả: Xóa lớp phủ đánh dấu đã được thêm trước đó cho phần tử.
  • Tham số:
    • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc được sử dụng khi thêm đánh dấu; phải khớp với giá trị đã truyền cho browser_highlight.
    • target (chuỗi, tùy chọn): Tham chiếu phần tử đích chính xác từ ảnh chụp nhanh trang, hoặc một bộ chọn phần tử duy nhất
  • Chỉ đọc: true

• browser_highlight
  • Tiêu đề: Đánh dấu phần tử
  • Mô tả: Hiển thị lớp phủ đánh dấu liên tục xung quanh phần tử trên trang.
  • Tham số:
    • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc được sử dụng để xin phép tương tác với phần tử
    • target (chuỗi): Tham chiếu phần tử đích chính xác từ ảnh chụp nhanh trang, hoặc một bộ chọn phần tử duy nhất
    • style (chuỗi, tùy chọn): CSS nội tuyến bổ sung áp dụng cho lớp phủ đánh dấu, ví dụ: "outline: 2px dashed red".
  • Chỉ đọc: true

• browser_resume
  • Tiêu đề: Tiếp tục thực thi script đã tạm dừng
  • Mô tả: Tiếp tục thực thi script sau khi nó bị tạm dừng. Khi được gọi với step đặt thành true, việc thực thi sẽ tạm dừng lại trước hành động tiếp theo.
  • Tham số:
    • step (boolean, tùy chọn): Khi true, việc thực thi sẽ tạm dừng lại trước hành động tiếp theo, cho phép gỡ lỗi từng bước.
    • location (chuỗi, tùy chọn): Tạm dừng thực thi tại một : cụ thể, ví dụ: "example.spec.ts:42".
  • Chỉ đọc: false

• browser_start_tracing
  • Tiêu đề: Bắt đầu tracing
  • Mô tả: Bắt đầu ghi trace
  • Tham số: Không có
  • Chỉ đọc: true

• browser_start_video
  • Tiêu đề: Bắt đầu quay video
  • Mô tả: Bắt đầu quay video
  • Tham số:
    • filename (chuỗi, tùy chọn): Tên tệp để lưu video.
    • size (đối tượng, tùy chọn): Kích thước video
  • Chỉ đọc: true

• browser_stop_tracing
  • Tiêu đề: Dừng tracing
  • Mô tả: Dừng ghi trace
  • Tham số: Không có
  • Chỉ đọc: true

• browser_stop_video
  • Tiêu đề: Dừng quay video
  • Mô tả: Dừng quay video
  • Tham số: Không có
  • Chỉ đọc: true

• browser_video_chapter
  • Tiêu đề: Chương video
  • Mô tả: Thêm điểm đánh dấu chương vào bản ghi video. Hiển thị thẻ chương toàn màn hình với nền mờ.
  • Tham số:
    • title (chuỗi): Tiêu đề chương
    • description (chuỗi, tùy chọn): Mô tả chương
    • duration (số, tùy chọn): Thời lượng tính bằng mili giây để hiển thị thẻ chương
  • Chỉ đọc: true

• browser_video_hide_actions
  • Tiêu đề: Ẩn lớp phủ hành động
  • Mô tả: Dừng chú thích các hành động được thực hiện trên trang.
  • Tham số: Không có
  • Chỉ đọc: true

• browser_video_show_actions
  • Tiêu đề: Hiển thị lớp phủ hành động
  • Mô tả: Chú thích các hành động tiếp theo được thực hiện trên trang bằng một chú thích gọi tên hành động và đánh dấu phần tử đích. Hữu ích khi đang quay video hoặc phát trực tiếp màn hình.
  • Tham số:
    • duration (số, tùy chọn): Thời gian mỗi chú thích hành động ở trên màn hình, tính bằng mili giây. Mặc định là 500.
    • position (chuỗi, tùy chọn): Vị trí đặt tiêu đề hành động so với trang. Mặc định là top-right.
    • cursor (chuỗi, tùy chọn): Trang trí con trỏ cho các hành động con trỏ. "pointer" (mặc định) tạo hiệu ứng động con trỏ chuột từ điểm hành động trước đó đến điểm tiếp theo; "none" vô hiệu hóa trang trí con trỏ.
  • Chỉ đọc: true

• browser_mouse_click_xy
  • Tiêu đề: Nhấp chuột
  • Mô tả: Nhấp nút chuột tại một vị trí nhất định
  • Tham số:
    • x (số): Tọa độ X
    • y (số): Tọa độ Y
    • button (chuỗi, tùy chọn): Nút để nhấp, mặc định là bên trái
    • clickCount (số, tùy chọn): Số lần nhấp, mặc định là 1
    • delay (số, tùy chọn): Thời gian chờ giữa nhấn và thả chuột tính bằng mili giây, mặc định là 0
  • Chỉ đọc: false

• browser_mouse_down
  • Tiêu đề: Nhấn giữ chuột
  • Mô tả: Nhấn giữ chuột
  • Tham số:
    • button (chuỗi, tùy chọn): Nút để nhấn, mặc định là bên trái
  • Chỉ đọc: false

• browser_mouse_drag_xy
  • Tiêu đề: Kéo chuột
  • Mô tả: Kéo nút chuột trái đến một vị trí nhất định
  • Tham số:
    • startX (số): Tọa độ X bắt đầu
    • startY (số): Tọa độ Y bắt đầu
    • endX (số): Tọa độ X kết thúc
    • endY (số): Tọa độ Y kết thúc
  • Chỉ đọc: false

• browser_mouse_move_xy
  • Tiêu đề: Di chuyển chuột
  • Mô tả: Di chuyển chuột đến một vị trí nhất định
  • Tham số:
    • x (số): Tọa độ X
    • y (số): Tọa độ Y
  • Chỉ đọc: false

• browser_mouse_up
  • Tiêu đề: Thả chuột
  • Mô tả: Thả chuột
  • Tham số:
    • button (chuỗi, tùy chọn): Nút để thả, mặc định là bên trái
  • Chỉ đọc: false

• browser_mouse_wheel
  • Tiêu đề: Cuộn bánh xe chuột
  • Mô tả: Cuộn bánh xe chuột
  • Tham số:
    • deltaX (số): Delta X
    • deltaY (số): Delta Y
  • Chỉ đọc: false

• browser_pdf_save
  • Tiêu đề: Lưu dưới dạng PDF
  • Mô tả: Lưu trang dưới dạng PDF
  • Tham số:
    • filename (chuỗi, tùy chọn): Tên tệp để lưu pdf. Mặc định là page-{timestamp}.pdf nếu không được chỉ định. Nên dùng tên tệp tương đối để nằm trong thư mục đầu ra.
  • Chỉ đọc: true

• browser_generate_locator
  • Tiêu đề: Tạo bộ định vị cho phần tử
  • Mô tả: Tạo bộ định vị cho phần tử đã cho để sử dụng trong kiểm thử
  • Tham số:
    • element (chuỗi, tùy chọn): Mô tả phần tử dễ đọc được sử dụng để xin phép tương tác với phần tử
    • target (chuỗi): Tham chiếu phần tử đích chính xác từ ảnh chụp nhanh trang, hoặc một bộ chọn phần tử duy nhất
  • Chỉ đọc: true

• browser_verify_element_visible
  • Tiêu đề: Xác minh phần tử hiển thị
  • Mô tả: Xác minh phần tử hiển thị trên trang
  • Tham số:
    • role (chuỗi): VAI TRÒ của phần tử. Có thể tìm thấy trong ảnh chụp nhanh như sau: - {ROLE} "Accessible Name":
    • accessibleName (chuỗi): TÊN_TRUY_CẬP của phần tử. Có thể tìm thấy trong ảnh chụp nhanh như sau: - role "{ACCESSIBLE_NAME}"
  • Chỉ đọc: false

• browser_verify_list_visible
  • Tiêu đề: Xác minh danh sách hiển thị
  • Mô tả: Xác minh danh sách hiển thị trên trang
  • Tham số:
    • element (chuỗi): Mô tả danh sách dễ đọc
    • target (chuỗi): Tham chiếu phần tử đích chính xác trỏ đến danh sách
    • items (mảng): Các mục cần xác minh
  • Chỉ đọc: false

• browser_verify_text_visible
  • Tiêu đề: Xác minh văn bản hiển thị
  • Mô tả: Xác minh văn bản hiển thị trên trang. Nên dùng browser_verify_element_visible nếu có thể.
  • Tham số:
    • text (chuỗi): VĂN BẢN cần xác minh. Có thể tìm thấy trong ảnh chụp nhanh như sau: - role "Accessible Name": {TEXT} hoặc như sau: - text: {TEXT}
  • Chỉ đọc: false

• browser_verify_value
  • Tiêu đề: Xác minh giá trị
  • Mô tả: Xác minh giá trị phần tử
  • Tham số:
    • type (chuỗi): Loại của phần tử
    • element (chuỗi): Mô tả phần tử dễ đọc
    • target (chuỗi): Tham chiếu phần tử đích chính xác từ ảnh chụp nhanh trang
    • value (chuỗi): Giá trị cần xác minh. Đối với hộp kiểm, sử dụng "true" hoặc "false".
  • Chỉ đọc: false