Playwright MCP

Amp VS Code uzantısı ayarlar ekranından veya settings.json dosyanızı güncelleyerek ekleyin:

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

Amp CLI Kurulumu:

Aşağıdaki amp mcp add komutuyla ekleyin

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

Antigravity ayarlarından veya yapılandırma dosyanızı güncelleyerek ekleyin:

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

Playwright MCP sunucusunu eklemek için Claude Code CLI'yi kullanın:

claude mcp add playwright npx @playwright/mcp@latest

MCP kurulum kılavuzunu izleyin, yukarıdaki standart yapılandırmayı kullanın.

MCP Sunucularını Yapılandırma bölümündeki talimatları izleyin

Örnek: Yerel Kurulum

cline_mcp_settings.json dosyanıza aşağıdakileri ekleyin:

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

Playwright MCP sunucusunu eklemek için Codex CLI'yi kullanın:

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

Alternatif olarak, ~/.codex/config.toml yapılandırma dosyasını oluşturun veya düzenleyin ve şunu ekleyin:

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

Daha fazla bilgi için Codex MCP belgelerine bakın.

Playwright MCP sunucusunu etkileşimli olarak eklemek için Copilot CLI'yi kullanın:

/mcp add

Alternatif olarak, ~/.copilot/mcp-config.json yapılandırma dosyasını oluşturun veya düzenleyin ve şunu ekleyin:

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

Daha fazla bilgi için Copilot CLI belgelerine bakın.

Kurmak için düğmeye tıklayın:

Veya manuel olarak kurun:

Cursor Settings -> MCP -> Add new MCP Server bölümüne gidin. Beğeninize göre adlandırın, npx @playwright/mcp@latest komutuyla command türünü kullanın. Ayrıca Edit seçeneğine tıklayarak yapılandırmayı doğrulayabilir veya komut gibi bağımsız değişkenler ekleyebilirsiniz.

Playwright MCP sunucusunu eklemek için Factory CLI'yi kullanın:

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

Alternatif olarak, MCP sunucularını yönetmek için etkileşimli bir UI açmak üzere Factory droid içinde /mcp yazın.

Daha fazla bilgi için Factory MCP belgelerine bakın.

MCP kurulum kılavuzunu izleyin, yukarıdaki standart yapılandırmayı kullanın.

Kurmak için düğmeye tıklayın:

Veya manuel olarak kurun:

Advanced settings -> Extensions -> Add custom extension bölümüne gidin. Beğeninize göre adlandırın, STDIO türünü kullanın ve command değerini npx @playwright/mcp olarak ayarlayın. "Add Extension" seçeneğine tıklayın.

Playwright MCP sunucusunu eklemek için Grok CLI'yi kullanın:

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

Alternatif olarak, ~/.grok/config.toml yapılandırma dosyasını oluşturun veya düzenleyin ve şunu ekleyin:

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

Daha fazla bilgi için Grok MCP belgelerine bakın.

Junie CLI'de Playwright MCP sunucusunu eklemek için:

1. /mcp yazın
2. Yeni bir MCP sunucusu eklemek için Ctrl+A tuşuna basın
3. Listeden Playwright seçeneğini seçin

Alternatif olarak, .junie/mcp/mcp.json dosyasına ekleyin:

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

Daha fazla bilgi için Junie MCP yapılandırma belgelerine bakın.

MCP Sunucuları belgelerini izleyin. Örneğin .kiro/settings/mcp.json içinde:

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

Kurmak için düğmeye tıklayın:

Veya manuel olarak kurun:

Sağ kenar çubuğunda Program bölümüne gidin -> Install -> Edit mcp.json. Yukarıdaki standart yapılandırmayı kullanın.

MCP Sunucuları belgelerini izleyin. Örneğin ~/.config/opencode/opencode.json içinde:

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

VSCode veya IntelliJ'de Qodo Gen sohbet panelini açın → Daha fazla araç bağla → + Yeni MCP ekle → Yukarıdaki standart yapılandırmayı yapıştırın.

Kaydet düğmesine tıklayın.

Kurmak için düğmeye tıklayın:

Veya manuel olarak kurun:

MCP kurulum kılavuzunu izleyin, yukarıdaki standart yapılandırmayı kullanın. Ayrıca Playwright MCP sunucusunu VS Code CLI'yi kullanarak da kurabilirsiniz:

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

Kurulumdan sonra, Playwright MCP sunucusu VS Code'da GitHub Copilot aracınızla kullanılabilir olacaktır.

MCP Sunucusu eklemek için Settings -> AI -> Manage MCP Servers -> + Add bölümüne gidin. Yukarıdaki standart yapılandırmayı kullanın.

Alternatif olarak, Warp isteminde /add-mcp eğik çizgi komutunu kullanın ve yukarıdaki standart yapılandırmayı yapıştırın:

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

Windsurf MCP belgelerini izleyin. Yukarıdaki standart yapılandırmayı kullanı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;

    /**
     * How long to wait after each action for triggered work (navigations, requests) to settle before responding. Defaults to 500ms.
     */
    settle?: 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';

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

NOT: Docker uygulaması şu anda yalnızca headless chromium destekler.

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

Veya MCP istemcisinin onu başlatmasına izin vermek yerine kapsayıcıyı uzun ömürlü bir hizmet olarak çalıştırmayı tercih ederseniz, şunu kullanın:

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

Sunucu, ana bilgisayar bağlantı noktası 8931 üzerinde dinler ve herhangi bir MCP istemcisi tarafından erişilebilir.

Docker görüntüsünü kendiniz oluşturabilirsiniz.

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
  • Başlık: Tıkla
  • Açıklama: Bir web sayfasında tıklama gerçekleştir
  • Parametreler:
    • element (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan, insan tarafından okunabilir öğe açıklaması
    • target (dize): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • doubleClick (boolean, isteğe bağlı): Tek tıklama yerine çift tıklama yapılıp yapılmayacağı
    • button (dize, isteğe bağlı): Tıklanacak düğme, varsayılan olarak sol
    • modifiers (dizi, isteğe bağlı): Basılacak değiştirici tuşlar
  • Salt okunur: false

• browser_close
  • Başlık: Tarayıcıyı kapat
  • Açıklama: Sayfayı kapat
  • Parametreler: Yok
  • Salt okunur: false

• browser_console_messages
  • Başlık: Konsol mesajlarını al
  • Açıklama: Tüm konsol mesajlarını döndürür
  • Parametreler:
    • level (dize): Döndürülecek konsol mesajlarının düzeyi. Her düzey, daha şiddetli düzeylerin mesajlarını içerir. Varsayılan "info"dur.
    • all (boolean, isteğe bağlı): Yalnızca son gezinmeden bu yana değil, oturumun başlangıcından bu yana tüm konsol mesajlarını döndür. Varsayılan false.
    • filename (dize, isteğe bağlı): Konsol mesajlarının kaydedileceği dosya adı. Sağlanmazsa, mesajlar metin olarak döndürülür.
  • Salt okunur: true

• browser_drag
  • Başlık: Fareyi sürükle
  • Açıklama: İki öğe arasında sürükle ve bırak gerçekleştir
  • Parametreler:
    • startElement (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan, insan tarafından okunabilir kaynak öğe açıklaması
    • startTarget (dize): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • endElement (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan, insan tarafından okunabilir hedef öğe açıklaması
    • endTarget (dize): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
  • Salt okunur: false

• browser_drop
  • Başlık: Dosyaları veya verileri bir öğeye bırak
  • Açıklama: Dosyaları veya MIME türünde verileri, sayfanın dışından sürüklenmiş gibi bir öğeye bırak. "paths" veya "data" alanlarından en az biri sağlanmalıdır.
  • Parametreler:
    • element (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan, insan tarafından okunabilir öğe açıklaması
    • target (dize): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • paths (dizi, isteğe bağlı): Öğeye bırakılacak dosyaların mutlak yolları.
    • data (nesne, isteğe bağlı): Bırakılacak veriler, MIME türünün dize değerine eşlendiği bir harita olarak (ör. {"text/plain": "hello", "text/uri-list": "https://example.com"}).
  • Salt okunur: false

• browser_evaluate
  • Başlık: JavaScript'i değerlendir
  • Açıklama: Sayfada veya öğede JavaScript ifadesini değerlendir
  • Parametreler:
    • element (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan, insan tarafından okunabilir öğe açıklaması
    • target (dize, isteğe bağlı): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • function (dize): () => { /* kod / } veya öğe sağlandığında (element) => { / kod */ }
    • filename (dize, isteğe bağlı): Sonucun kaydedileceği dosya adı. Sağlanmazsa, sonuç metin olarak döndürülür.
  • Salt okunur: false

• browser_file_upload
  • Başlık: Dosyaları yükle
  • Açıklama: Bir veya birden fazla dosyayı yükle
  • Parametreler:
    • paths (dizi, isteğe bağlı): Yüklenecek dosyaların mutlak yolları. Tek dosya veya birden fazla dosya olabilir. Atlanırsa, dosya seçici iptal edilir.
  • Salt okunur: false

• browser_fill_form
  • Başlık: Formu doldur
  • Açıklama: Birden fazla form alanını doldur
  • Parametreler:
    • fields (dizi): Doldurulacak alanlar
  • Salt okunur: false

• browser_find
  • Başlık: Sayfa anlık görüntüsünde bul
  • Açıklama: Geçerli sayfanın erişilebilirlik anlık görüntüsünde metin veya normal ifade arayın. Eşleşen anlık görüntü düğümlerini, her biri ağacın kökünden kendi yolu altında gösterilen birkaç satır çevreleyen bağlamla (arama parçacıkları gibi) döndürür; bu, yalnızca bir öğeyi ve referansını bulmanız gerektiğinde tüm anlık görüntüyü yakalamaktan daha ucuzdur.
  • Parametreler:
    • text (dize, isteğe bağlı): Sayfa anlık görüntüsünde aranacak düz metin (büyük/küçük harfe duyarsız alt dize eşleşmesi). Yalnızca metin veya normal ifade sağlayın, ikisini birden değil.
    • regex (dize, isteğe bağlı): Sayfa anlık görüntüsünde aranacak normal ifade. Eşleştirme varsayılan olarak büyük/küçük harfe duyarlıdır; bayrak eklemek için deseni eğik çizgilere sarın, ör. büyük/küçük harfe duyarsız için "/error/i". Yalnızca metin veya normal ifade sağlayın, ikisini birden değil.
  • Salt okunur: true

• browser_handle_dialog
  • Başlık: Bir iletişim kutusunu işle
  • Açıklama: Bir iletişim kutusunu işle
  • Parametreler:
    • accept (boolean): İletişim kutusunun kabul edilip edilmeyeceği.
    • promptText (dize, isteğe bağlı): Bir istem iletişim kutusu durumunda istemin metni.
  • Salt okunur: false

• browser_hover
  • Başlık: Fareyi üzerine getir
  • Açıklama: Sayfadaki öğenin üzerine gel
  • Parametreler:
    • element (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan, insan tarafından okunabilir öğe açıklaması
    • target (dize): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
  • Salt okunur: false

• browser_navigate
  • Başlık: Bir URL'ye git
  • Açıklama: Bir URL'ye git
  • Parametreler:
    • url (dize): Gidilecek URL
  • Salt okunur: false

• browser_navigate_back
  • Başlık: Geri git
  • Açıklama: Geçmişteki önceki sayfaya geri dön
  • Parametreler: Yok
  • Salt okunur: false

• browser_network_request
  • Başlık: Ağ isteği ayrıntılarını göster
  • Açıklama: Tek bir ağ isteğinin tam ayrıntılarını (başlıklar ve gövde) veya part ayarlanmışsa tek bir bölümünü döndürür. browser_network_requests'ten gelen numarayı kullanın.
  • Parametreler:
    • index (tamsayı): browser_network_requests tarafından yazdırıldığı gibi isteğin 1 tabanlı dizini.
    • part (dize, isteğe bağlı): Yalnızca isteğin bu bölümünü döndür. Tam ayrıntıları döndürmek için atlayın.
    • filename (dize, isteğe bağlı): Sonucun kaydedileceği dosya adı. Sağlanmazsa, çıktı metin olarak döndürülür.
  • Salt okunur: true

• browser_network_requests
  • Başlık: Ağ isteklerini listele
  • Açıklama: Sayfa yüklendiğinden bu yana numaralı bir ağ istekleri listesi döndürür. Tam ayrıntıları almak için numarayla browser_network_request kullanın.
  • Parametreler:
    • static (boolean): Görüntüler, yazı tipleri, komut dosyaları vb. gibi başarılı statik kaynakların dahil edilip edilmeyeceği. Varsayılan false.
    • filter (dize, isteğe bağlı): Yalnızca URL'si bu normal ifadeyle eşleşen istekleri döndür (ör. "/api/.*user").
    • filename (dize, isteğe bağlı): Ağ isteklerinin kaydedileceği dosya adı. Sağlanmazsa, istekler metin olarak döndürülür.
  • Salt okunur: true

• browser_press_key
  • Başlık: Bir tuşa bas
  • Açıklama: Klavyede bir tuşa bas
  • Parametreler:
    • key (dize): Basılacak tuşun adı veya oluşturulacak bir karakter, ör. ArrowLeft veya a
  • Salt okunur: false

• browser_resize
  • Başlık: Tarayıcı penceresini yeniden boyutlandır
  • Açıklama: Tarayıcı penceresini yeniden boyutlandır
  • Parametreler:
    • width (sayı): Tarayıcı penceresinin genişliği
    • height (sayı): Tarayıcı penceresinin yüksekliği
  • Salt okunur: false

• browser_run_code_unsafe
  • Başlık: Playwright kodunu çalıştır (güvenli değil)
  • Açıklama: Bir Playwright kod parçacığını çalıştır. Güvenli değil: Playwright sunucu sürecinde rastgele JavaScript yürütür ve RCE'ye eşdeğerdir.
  • Parametreler:
    • code (dize, isteğe bağlı): Yürütülecek Playwright kodunu içeren bir JavaScript işlevi. Herhangi bir sayfa etkileşimi için kullanabileceğiniz tek bir bağımsız değişken olan page ile çağrılır. Örneğin: async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }
    • filename (dize, isteğe bağlı): Kodu belirtilen dosyadan yükle. Hem kod hem de dosya adı sağlanırsa, kod yok sayılır.
  • Salt okunur: false

• browser_select_option
  • Başlık: Seçenek seç
  • Açıklama: Açılır listede bir seçenek seç
  • Parametreler:
    • element (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan, insan tarafından okunabilir öğe açıklaması
    • target (dize): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • values (dizi): Açılır listede seçilecek değerler dizisi. Bu tek bir değer veya birden fazla değer olabilir.
  • Salt okunur: false

• browser_snapshot
  • Başlık: Sayfa anlık görüntüsü
  • Açıklama: Geçerli sayfanın erişilebilirlik anlık görüntüsünü yakala, bu ekran görüntüsünden daha iyidir
  • Parametreler:
    • target (dize, isteğe bağlı): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • filename (dize, isteğe bağlı): Anlık görüntüyü yanıtta döndürmek yerine markdown dosyasına kaydet.
    • depth (sayı, isteğe bağlı): Anlık görüntü ağacının derinliğini sınırla
    • boxes (boolean, isteğe bağlı): Her öğenin sınırlayıcı kutusunu anlık görüntüde [box=x,y,width,height] olarak dahil et. Koordinatlar görünüm alanına görelidir, CSS piksel cinsindendir (Element.getBoundingClientRect)
  • Salt okunur: true

• browser_take_screenshot
  • Başlık: Ekran görüntüsü al
  • Açıklama: Geçerli sayfanın ekran görüntüsünü al. Ekran görüntüsüne dayalı eylemler gerçekleştiremezsiniz, eylemler için browser_snapshot kullanın.
  • Parametreler:
    • element (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan, insan tarafından okunabilir öğe açıklaması
    • target (dize, isteğe bağlı): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • type (dize, isteğe bağlı): Ekran görüntüsü için görüntü biçimi. Ayarlanmazsa, dosya adı uzantısından çıkarılır, aksi takdirde png.
    • filename (dize, isteğe bağlı): Ekran görüntüsünün kaydedileceği dosya adı. Belirtilmezse varsayılan page-{timestamp}.{png|jpeg|webp}'dir. Çıktı dizini içinde kalmak için göreli dosya adlarını tercih edin.
    • fullPage (boolean, isteğe bağlı): true olduğunda, şu anda görünür olan görünüm alanı yerine tam kaydırılabilir sayfanın ekran görüntüsünü alır. Öğe ekran görüntüleriyle kullanılamaz.
    • scale (dize): Görüntü çözünürlük ölçeği. "css", CSS piksel cinsinden boyutlandırılmış bir ekran görüntüsü üretir (daha küçük, cihazlar arasında tutarlı). "device", cihaz piksellerini kullanan yüksek çözünürlüklü bir ekran görüntüsü üretir (daha büyük, cihaz piksel oranını hesaba katar). Varsayılan css'tir.
  • Salt okunur: true

• browser_type
  • Başlık: Metin yaz
  • Açıklama: Düzenlenebilir öğeye metin yaz
  • Parametreler:
    • element (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan, insan tarafından okunabilir öğe açıklaması
    • target (dize): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • text (dize): Öğeye yazılacak metin
    • submit (boolean, isteğe bağlı): Girilen metnin gönderilip gönderilmeyeceği (sonrasında Enter'a bas)
    • slowly (boolean, isteğe bağlı): Her seferinde bir karakter yazılıp yazılmayacağı. Sayfadaki tuş işleyicilerini tetiklemek için kullanışlıdır. Varsayılan olarak metnin tamamı bir kerede doldurulur.
  • Salt okunur: false

• browser_wait_for
  • Başlık: Bekle
  • Açıklama: Metnin görünmesini veya kaybolmasını ya da belirtilen sürenin geçmesini bekler
  • Parametreler:
    • time (sayı, isteğe bağlı): Beklenecek süre (saniye cinsinden)
    • text (metin, isteğe bağlı): Beklenecek metin
    • textGone (metin, isteğe bağlı): Kaybolması beklenen metin
  • Salt okunur: false

• browser_tabs
  • Başlık: Sekmeleri yönet
  • Açıklama: Tarayıcı sekmesini listeler, oluşturur, kapatır veya seçer.
  • Parametreler:
    • action (metin): Gerçekleştirilecek işlem
    • index (sayı, isteğe bağlı): Sekme dizini, kapatma/seçme için kullanılır. Kapatma için atlanırsa geçerli sekme kapatılır.
    • url (metin, isteğe bağlı): Yeni sekmede gidilecek URL, yeni sekme için kullanılır.
  • Salt okunur: false

• browser_get_config
  • Başlık: Yapılandırmayı al
  • Açıklama: CLI seçenekleri, ortam değişkenleri ve yapılandırma dosyası birleştirildikten sonraki son çözümlenmiş yapılandırmayı alır.
  • Parametreler: Yok
  • Salt okunur: true

• browser_network_state_set
  • Başlık: Ağ durumunu ayarla
  • Açıklama: Tarayıcı ağ durumunu çevrimiçi veya çevrimdışı olarak ayarlar. Çevrimdışıyken tüm ağ istekleri başarısız olur.
  • Parametreler:
    • state (metin): Çevrimdışı modu simüle etmek için "offline", ağ bağlantısını geri yüklemek için "online" olarak ayarlayın
  • Salt okunur: false

• browser_route
  • Başlık: Ağ isteklerini simüle et
  • Açıklama: Bir URL deseniyle eşleşen ağ isteklerini simüle etmek için bir rota ayarlar
  • Parametreler:
    • pattern (metin): Eşleştirilecek URL deseni (ör. "/api/users", "/*.{png,jpg}")
    • status (sayı, isteğe bağlı): Döndürülecek HTTP durum kodu (varsayılan: 200)
    • body (metin, isteğe bağlı): Yanıt gövdesi (metin veya JSON dizesi)
    • contentType (metin, isteğe bağlı): Content-Type başlığı (ör. "application/json", "text/html")
    • headers (dizi, isteğe bağlı): "Ad: Değer" biçiminde eklenecek başlıklar
    • removeHeaders (metin, isteğe bağlı): İstekten kaldırılacak başlık adlarının virgülle ayrılmış listesi
  • Salt okunur: false

• browser_route_list
  • Başlık: Ağ rotalarını listele
  • Açıklama: Tüm etkin ağ rotalarını listeler
  • Parametreler: Yok
  • Salt okunur: true

• browser_unroute
  • Başlık: Ağ rotalarını kaldır
  • Açıklama: Bir desenle eşleşen ağ rotalarını kaldırır (desen belirtilmezse tüm rotaları kaldırır)
  • Parametreler:
    • pattern (metin, isteğe bağlı): Kaldırılacak URL deseni (tüm rotaları kaldırmak için atlayın)
  • Salt okunur: false

• browser_cookie_clear
  • Başlık: Çerezleri temizle
  • Açıklama: Tüm çerezleri temizler
  • Parametreler: Yok
  • Salt okunur: false

• browser_cookie_delete
  • Başlık: Çerezi sil
  • Açıklama: Belirli bir çerezi siler
  • Parametreler:
    • name (metin): Silinecek çerez adı
  • Salt okunur: false

• browser_cookie_get
  • Başlık: Çerezi al
  • Açıklama: Ada göre belirli bir çerezi alır
  • Parametreler:
    • name (metin): Alınacak çerez adı
  • Salt okunur: true

• browser_cookie_list
  • Başlık: Çerezleri listele
  • Açıklama: Tüm çerezleri listeler (isteğe bağlı olarak alan adı/yola göre filtrelenir)
  • Parametreler:
    • domain (metin, isteğe bağlı): Çerezleri alan adına göre filtrele
    • path (metin, isteğe bağlı): Çerezleri yola göre filtrele
  • Salt okunur: true

• browser_cookie_set
  • Başlık: Çerez ayarla
  • Açıklama: İsteğe bağlı bayraklarla (alan adı, yol, son kullanma, httpOnly, secure, sameSite) bir çerez ayarlar
  • Parametreler:
    • name (metin): Çerez adı
    • value (metin): Çerez değeri
    • domain (metin, isteğe bağlı): Çerez alan adı
    • path (metin, isteğe bağlı): Çerez yolu
    • expires (sayı, isteğe bağlı): Unix zaman damgası olarak çerez son kullanma süresi
    • httpOnly (boolean, isteğe bağlı): Çerezin yalnızca HTTP olup olmadığı
    • secure (boolean, isteğe bağlı): Çerezin güvenli olup olmadığı
    • sameSite (metin, isteğe bağlı): Çerez SameSite özelliği
  • Salt okunur: false

• browser_localstorage_clear
  • Başlık: localStorage'ı temizle
  • Açıklama: Tüm localStorage'ı temizler
  • Parametreler: Yok
  • Salt okunur: false

• browser_localstorage_delete
  • Başlık: localStorage öğesini sil
  • Açıklama: Bir localStorage öğesini siler
  • Parametreler:
    • key (metin): Silinecek anahtar
  • Salt okunur: false

• browser_localstorage_get
  • Başlık: localStorage öğesini al
  • Açıklama: Anahtara göre bir localStorage öğesini alır
  • Parametreler:
    • key (metin): Alınacak anahtar
  • Salt okunur: true

• browser_localstorage_list
  • Başlık: localStorage'ı listele
  • Açıklama: Tüm localStorage anahtar-değer çiftlerini listeler
  • Parametreler: Yok
  • Salt okunur: true

• browser_localstorage_set
  • Başlık: localStorage öğesi ayarla
  • Açıklama: Bir localStorage öğesi ayarlar
  • Parametreler:
    • key (metin): Ayarlanacak anahtar
    • value (metin): Ayarlanacak değer
  • Salt okunur: false

• browser_sessionstorage_clear
  • Başlık: sessionStorage'ı temizle
  • Açıklama: Tüm sessionStorage'ı temizler
  • Parametreler: Yok
  • Salt okunur: false

• browser_sessionstorage_delete
  • Başlık: sessionStorage öğesini sil
  • Açıklama: Bir sessionStorage öğesini siler
  • Parametreler:
    • key (metin): Silinecek anahtar
  • Salt okunur: false

• browser_sessionstorage_get
  • Başlık: sessionStorage öğesini al
  • Açıklama: Anahtara göre bir sessionStorage öğesini alır
  • Parametreler:
    • key (metin): Alınacak anahtar
  • Salt okunur: true

• browser_sessionstorage_list
  • Başlık: sessionStorage'ı listele
  • Açıklama: Tüm sessionStorage anahtar-değer çiftlerini listeler
  • Parametreler: Yok
  • Salt okunur: true

• browser_sessionstorage_set
  • Başlık: sessionStorage öğesi ayarla
  • Açıklama: Bir sessionStorage öğesi ayarlar
  • Parametreler:
    • key (metin): Ayarlanacak anahtar
    • value (metin): Ayarlanacak değer
  • Salt okunur: false

• browser_set_storage_state
  • Başlık: Depolama durumunu geri yükle
  • Açıklama: Bir dosyadan depolama durumunu (çerezler, yerel depolama) geri yükler. Bu, geri yüklemeden önce mevcut çerezleri ve yerel depolamayı temizler.
  • Parametreler:
    • filename (metin): Geri yüklenecek depolama durumu dosyasının yolu
  • Salt okunur: false

• browser_storage_state
  • Başlık: Depolama durumunu kaydet
  • Açıklama: Depolama durumunu (çerezler, yerel depolama) daha sonra yeniden kullanmak üzere bir dosyaya kaydeder
  • Parametreler:
    • filename (metin, isteğe bağlı): Depolama durumunun kaydedileceği dosya adı. Belirtilmezse varsayılan olarak storage-state-{timestamp}.json kullanılır.
  • Salt okunur: true

• browser_annotate
  • Başlık: Geçerli sayfayı açıkla
  • Açıklama: Geçerli sayfa için Playwright Panosu'nu açıklama modunda açar ve kullanıcının açıklamalar çizmesini bekler. Açıklamalı ekran görüntüsünü, ARIA anlık görüntüsünü ve açıklamaların listesini döndürür.
  • Parametreler: Yok
  • Salt okunur: true

• browser_hide_highlight
  • Başlık: Öğe vurgusunu gizle
  • Açıklama: Öğe için daha önce eklenen bir vurgu katmanını kaldırır.
  • Parametreler:
    • element (metin, isteğe bağlı): Vurgu eklenirken kullanılan insan tarafından okunabilir öğe açıklaması; browser_highlight'a iletilen değerle eşleşmelidir.
    • target (metin, isteğe bağlı): Sayfa anlık görüntüsünden hedef öğe referansı veya benzersiz bir öğe seçici
  • Salt okunur: true

• browser_highlight
  • Başlık: Öğeyi vurgula
  • Açıklama: Sayfadaki öğenin çevresinde kalıcı bir vurgu katmanı gösterir.
  • Parametreler:
    • element (metin, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (metin): Sayfa anlık görüntüsünden hedef öğe referansı veya benzersiz bir öğe seçici
    • style (metin, isteğe bağlı): Vurgu katmanına uygulanan ek satır içi CSS, ör. "outline: 2px dashed red".
  • Salt okunur: true

• browser_resume
  • Başlık: Duraklatılmış betik yürütmeyi sürdür
  • Açıklama: Duraklatıldıktan sonra betik yürütmeyi sürdürür. step true olarak çağrıldığında, yürütme bir sonraki eylemden önce yeniden duraklatılır.
  • Parametreler:
    • step (boolean, isteğe bağlı): true olduğunda, yürütme bir sonraki eylemden önce yeniden duraklatılır ve adım adım hata ayıklamaya olanak tanır.
    • location (metin, isteğe bağlı): Belirli bir : konumunda yürütmeyi duraklatır, ör. "example.spec.ts:42".
  • Salt okunur: false

• browser_start_recording
  • Başlık: Kullanıcı eylemlerini kaydetmeye başla
  • Açıklama: Kullanıcının tarayıcıda gerçekleştirdiği eylemleri Playwright kodu olarak kaydetmeye başlar. Kullanıcı bir akışı elle göstermek istediğinde kullanın. Kaydedilen eylemleri almak için kullanıcı bittiğini söylediğinde browser_stop_recording çağırın.
  • Parametreler: Yok
  • Salt okunur: true

• browser_start_tracing
  • Başlık: İzlemeyi başlat
  • Açıklama: İz kaydını başlatır
  • Parametreler: Yok
  • Salt okunur: true

• browser_start_video
  • Başlık: Videoyu başlat
  • Açıklama: Video kaydını başlatır
  • Parametreler:
    • filename (metin, isteğe bağlı): Videonun kaydedileceği dosya adı.
    • size (nesne, isteğe bağlı): Video boyutu
  • Salt okunur: true

• browser_stop_recording
  • Başlık: Kullanıcı eylemlerini kaydetmeyi durdur
  • Açıklama: browser_start_recording ile başlatılan kaydı durdurur ve kaydedilen eylemleri Playwright kodu olarak döndürür.
  • Parametreler: Yok
  • Salt okunur: true

• browser_stop_tracing
  • Başlık: İzlemeyi durdur
  • Açıklama: İz kaydını durdurur
  • Parametreler: Yok
  • Salt okunur: true

• browser_stop_video
  • Başlık: Videoyu durdur
  • Açıklama: Video kaydını durdurur
  • Parametreler: Yok
  • Salt okunur: true

• browser_video_chapter
  • Başlık: Video bölümü
  • Açıklama: Video kaydına bir bölüm işareti ekler. Bulanık arka planlı tam ekran bölüm kartı gösterir.
  • Parametreler:
    • title (metin): Bölüm başlığı
    • description (metin, isteğe bağlı): Bölüm açıklaması
    • duration (sayı, isteğe bağlı): Bölüm kartının gösterileceği süre (milisaniye cinsinden)
  • Salt okunur: true

• browser_video_hide_actions
  • Başlık: Eylem katmanlarını gizle
  • Açıklama: Sayfada gerçekleştirilen eylemleri açıklamayı durdurur.
  • Parametreler: Yok
  • Salt okunur: true

• browser_video_show_actions
  • Başlık: Eylem katmanlarını göster
  • Açıklama: Sayfada gerçekleştirilen sonraki eylemleri, eylemi adlandıran ve hedef öğeyi vurgulayan bir çağrı balonu ile açıklayın. Video kaydı veya ekran kaydı sırasında kullanışlıdır.
  • Parametreler:
    • duration (sayı, isteğe bağlı): Her eylem açıklamasının ekranda ne kadar süre kalacağı, milisaniye cinsinden. Varsayılan 500.
    • position (dize, isteğe bağlı): Eylem başlığının sayfaya göre nereye yerleştirileceği. Varsayılan sağ üst.
    • cursor (dize, isteğe bağlı): İşaretçi eylemleri için imleç dekorasyonu. "pointer" (varsayılan) bir fare işaretçisini önceki eylem noktasından sonrakine animasyonla taşır; "none" imleç dekorasyonunu devre dışı bırakır.
  • Salt okunur: true

• browser_mouse_click_xy
  • Başlık: Tıkla
  • Açıklama: Belirli bir konumda fare düğmesine tıklayın
  • Parametreler:
    • x (sayı): X koordinatı
    • y (sayı): Y koordinatı
    • button (dize, isteğe bağlı): Tıklanacak düğme, varsayılan sol
    • clickCount (sayı, isteğe bağlı): Tıklama sayısı, varsayılan 1
    • delay (sayı, isteğe bağlı): Fare basma ve bırakma arasında beklenecek süre, milisaniye cinsinden, varsayılan 0
  • Salt okunur: false

• browser_mouse_down
  • Başlık: Fareyi basılı tut
  • Açıklama: Fareyi basılı tut
  • Parametreler:
    • button (dize, isteğe bağlı): Basılacak düğme, varsayılan sol
  • Salt okunur: false

• browser_mouse_drag_xy
  • Başlık: Fareyi sürükle
  • Açıklama: Sol fare düğmesini belirli bir konuma sürükleyin
  • Parametreler:
    • startX (sayı): Başlangıç X koordinatı
    • startY (sayı): Başlangıç Y koordinatı
    • endX (sayı): Bitiş X koordinatı
    • endY (sayı): Bitiş Y koordinatı
  • Salt okunur: false

• browser_mouse_move_xy
  • Başlık: Fareyi taşı
  • Açıklama: Fareyi belirli bir konuma taşıyın
  • Parametreler:
    • x (sayı): X koordinatı
    • y (sayı): Y koordinatı
  • Salt okunur: false

• browser_mouse_up
  • Başlık: Fareyi bırak
  • Açıklama: Fareyi bırak
  • Parametreler:
    • button (dize, isteğe bağlı): Bırakılacak düğme, varsayılan sol
  • Salt okunur: false

• browser_mouse_wheel
  • Başlık: Fare tekerleğini kaydır
  • Açıklama: Fare tekerleğini kaydır
  • Parametreler:
    • deltaX (sayı): X delta
    • deltaY (sayı): Y delta
  • Salt okunur: false

• browser_pdf_save
  • Başlık: PDF olarak kaydet
  • Açıklama: Sayfayı PDF olarak kaydet
  • Parametreler:
    • filename (dize, isteğe bağlı): PDF'in kaydedileceği dosya adı. Belirtilmezse varsayılan page-{timestamp}.pdf. Çıktı dizini içinde kalmak için göreli dosya adlarını tercih edin.
  • Salt okunur: true

• browser_generate_locator
  • Başlık: Öğe için konumlandırıcı oluştur
  • Açıklama: Testlerde kullanmak üzere verilen öğe için konumlandırıcı oluşturun
  • Parametreler:
    • element (dize, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (dize): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
  • Salt okunur: true

• browser_verify_element_visible
  • Başlık: Öğenin görünür olduğunu doğrula
  • Açıklama: Öğenin sayfada görünür olduğunu doğrulayın
  • Parametreler:
    • role (dize): Öğenin ROLE'u. Anlık görüntüde şu şekilde bulunabilir: - {ROLE} "Accessible Name":
    • accessibleName (dize): Öğenin ACCESSIBLE_NAME'i. Anlık görüntüde şu şekilde bulunabilir: - role "{ACCESSIBLE_NAME}"
  • Salt okunur: false

• browser_verify_list_visible
  • Başlık: Listenin görünür olduğunu doğrula
  • Açıklama: Listenin sayfada görünür olduğunu doğrulayın
  • Parametreler:
    • element (dize): İnsan tarafından okunabilir liste açıklaması
    • target (dize): Listeyi işaret eden tam hedef öğe referansı
    • items (dizi): Doğrulanacak öğeler
  • Salt okunur: false

• browser_verify_text_visible
  • Başlık: Metnin görünür olduğunu doğrula
  • Açıklama: Metnin sayfada görünür olduğunu doğrulayın. Mümkünse browser_verify_element_visible tercih edin.
  • Parametreler:
    • text (dize): Doğrulanacak METİN. Anlık görüntüde şu şekilde bulunabilir: - role "Accessible Name": {TEXT} veya şu şekilde: - text: {TEXT}
  • Salt okunur: false

• browser_verify_value
  • Başlık: Değeri doğrula
  • Açıklama: Öğe değerini doğrulayın
  • Parametreler:
    • type (dize): Öğenin türü
    • element (dize): İnsan tarafından okunabilir öğe açıklaması
    • target (dize): Sayfa anlık görüntüsünden tam hedef öğe referansı
    • value (dize): Doğrulanacak değer. Onay kutusu için "true" veya "false" kullanın.
  • Salt okunur: false