> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/integrations/pt-br/proxy-integrations/playwright.md).

# Playwright

Integre o Playwright com Proxies da Oxylabs para automação de navegador – um guia de configuração em Node.js com exemplos de código.

[**Playwright**](https://playwright.dev/) é uma biblioteca Node.js que permite escrever scripts e automatizar navegadores usando a mesma API, como Chrome, Firefox e Safari. É um framework conveniente para automação e testes.

Assista ao nosso guia em vídeo ou siga as etapas abaixo para integrar o Playwright com os seguintes Proxies Oxylabs:

* [**Residential & Mobile Proxies**](#residential-and-mobile-proxies)
* [**Datacenter Proxies**](#datacenter-proxies)
* [**Dedicated Datacenter Proxies (Empresarial)**](#dedicated-datacenter-proxies-enterprise)
* [**Dedicated Datacenter Proxies (Autoatendimento)**](#dedicated-datacenter-proxies-self-service)
* [**ISP Proxies**](#isp-proxies)
* [**Dedicated ISP Proxies**](#dedicated-isp-proxies)

{% embed url="<https://youtu.be/KIsQ7ggB5DU>" %}

### **Etapa 1**

Instale [Node.js](https://nodejs.org/en/download) e um editor de código de sua preferência. (Pule esta etapa se você já tiver isso)

### **Etapa 2**

Crie um projeto Node.js e instale os pacotes necessários.

### **Etapa 3**

Dentro do seu script do Playwright, preencha os `'proxy'` valores como mostrado abaixo:

```javascript
proxy: {
    server: 'protocol-host-port',
    username: 'USERNAME',
    password: 'PASSWORD'
},
```

Insira seu `valor de` server de acordo com o tipo de proxy Oxylabs escolhido:

* [Residential & Mobile Proxies](#residential-and-mobile-proxies)
* [Datacenter Proxies](#datacenter-proxies)
* [Dedicated Datacenter Proxies (Empresarial)](#dedicated-datacenter-proxies-enterprise)
* [Dedicated Datacenter Proxies (Autoatendimento)](#dedicated-datacenter-proxies-self-service)
* [ISP Proxies](#isp-proxies)
* [Dedicated ISP Proxies](#dedicated-isp-proxies)

#### Residential & Mobile Proxies

```javascript
server: 'http://pr.oxylabs.io:7777' //protocol-host-port
```

**Protocolo:** `http`, `https`, ou `socks5h`

**Host:** `pr.oxylabs.io`

**Porta:** `7777`

**Nome de usuário:** `customer-USERNAME`

**Senha:** `PASSWORD`

{% hint style="warning" %}
**Observação:** Não se esqueça de adicionar `customer-` prefixo ao seu nome de usuário.
{% endhint %}

Você também pode usar **parâmetros adicionais** com proxies residenciais e móveis para definir a geolocalização (país, estado, cidade etc.) e controlar sessões. Confira o [para saber mais.](/products/pt-br/proxies/residential-proxies.md) Dedicated Datacenter Proxies empresariais

#### Datacenter Proxies

```javascript
server: 'http://dc.oxylabs.io:8001' //protocol-host-port
```

**Protocolo:** `http`, `https`, ou `socks5h`

**Host:** `dc.oxylabs.io`

**Porta:** `8001`

**Nome de usuário:** `user-username`

**Senha:** `senha`

{% hint style="warning" %}
**Observação:** Não se esqueça de adicionar `user-` prefixo ao seu nome de usuário.
{% endhint %}

**Assinatura pay-per-IP**

A porta é o número sequencial atribuído a um endereço IP da [lista de proxies adquirida](/products/pt-br/proxies/datacenter-proxies/proxy-list.md). Assim, a porta `8001` usa o primeiro endereço IP da sua lista. Você também pode ativar [de IP do proxy](/products/pt-br/proxies/datacenter-proxies/ip-control.md) definindo a porta como `8000`.

Além disso, você pode especificar o [geolocalização](/products/pt-br/proxies/datacenter-proxies/select-country.md), por exemplo, os EUA, definindo o **Nome de usuário do proxy** para `user-USERNAME-country-US`.

**Assinatura pay-per-traffic**

A porta `8001` escolhe um endereço IP aleatório, mas permanece consistente durante uma sessão. Como alternativa, você pode [alternar os IPs do proxy](/products/pt-br/proxies/datacenter-proxies/ip-control.md) a cada solicitação usando a porta `8000`.

Se você quiser usar um [geolocalização](/products/pt-br/proxies/datacenter-proxies/select-country.md), por exemplo, os EUA, defina o nome de usuário do proxy como `user-USERNAME-country-US`.

#### Dedicated Datacenter Proxies (Empresarial)

```javascript
server: 'http://1.2.3.4:60000' //protocol-host-port
```

**Protocolo:** `http`, ou `socks5h`

**Host:** `1.2.3.4` (endereço IP da sua [lista de proxies adquirida](/products/pt-br/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md))

**Porta:** `60000` (SOCKS5) `1180` USERNAME

**Nome de usuário:** `nome de usuário`

**Senha:** `senha`

Para Enterprise Dedicated Datacenter Proxies (adquiridos por meio da equipe de vendas), você terá que escolher um endereço IP do conjunto adquirido [lista de proxies adquirida](/products/pt-br/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md).

#### Dedicated Datacenter Proxies (Autoatendimento)

```javascript
server: 'http://ddc.oxylabs.io:8001' //protocol-host-port
```

**Protocolo:** `http`, `https`, ou `socks5h`

**Host:** `ddc.oxylabs.io`

**Porta:** `8001`

**Nome de usuário:** `user-username`

**Senha:** `senha`

{% hint style="warning" %}
**Observação:** Não se esqueça de adicionar `user-` prefixo ao seu nome de usuário.
{% endhint %}

Para Self-Service Dedicated Datacenter Proxies (adquiridos pelo painel da Oxylabs), a porta indica o número sequencial de um endereço IP do conjunto adquirido [lista de proxies adquirida](/products/pt-br/proxies/dedicated-datacenter-proxies/self-service/proxy-list.md). Se você quiser obter um IP diferente a cada solicitação, altere a Porta para `8000` para ativar [rotação de proxy](/products/pt-br/proxies/dedicated-datacenter-proxies/self-service/proxy-rotation.md).

#### ISP Proxies

```javascript
server: 'http://isp.oxylabs.io:8001' //protocol-host-port
```

**Protocolo:** `http`, `https`, ou `socks5h`

**Host:** `isp.oxylabs.io`

**Porta:** `8001`

**Nome de usuário:** `user-username`

**Senha:** `senha`

{% hint style="warning" %}
**Observação:** Não se esqueça de adicionar `user-` prefixo ao seu nome de usuário.
{% endhint %}

Com ISP Proxies, a porta é atribuída a um endereço IP específico e à sua localização. Portanto, a porta `8001` sempre escolherá o primeiro IP da sua [lista de proxies adquirida](/products/pt-br/proxies/isp-proxies/proxy-list.md). Se você quiser obter um IP diferente a cada solicitação, altere a Porta para `8000` para ativar [rotação de proxy](/products/pt-br/proxies/isp-proxies/proxy-rotation.md).

#### Dedicated ISP Proxies

```javascript
server: 'http://disp.oxylabs.io:7777' //protocol-host-port
```

**Protocolo:** `http`, `https`, ou `socks5h`

**Host:** `disp.oxylabs.io`

**Porta:** `8001`

**Nome de usuário:** `user-username`

**Senha:** `senha`

{% hint style="warning" %}
**Observação:** Não se esqueça de adicionar `user-` prefixo ao seu nome de usuário.
{% endhint %}

Você precisará escolher a porta atribuída a um endereço IP da lista comprada [lista de proxies adquirida](/products/pt-br/proxies/dedicated-isp-proxies/self-service/proxy-list.md), que você pode encontrar no painel da Oxylabs. A `8001` porta selecionará o primeiro endereço IP da sua lista para todas as solicitações. Use a porta `8000` para rotação automática [de IP do proxy](/products/pt-br/proxies/dedicated-isp-proxies/self-service/proxy-rotation.md).

### Exemplo de código completo

```javascript
const playwright = require('playwright');
(async () => {
    for (const browserType of ['chromium', 'firefox', 'webkit']) {
        const browser = await playwright[browserType].launch({
            headless: false,
            proxy: {
                server: 'http://pr.oxylabs.io:7777',
                username: 'USERNAME',
                password: 'PASSWORD'
            },
        });
        const context = await browser.newContext();
        const page = await context.newPage();
        await page.goto('https://ip.oxylabs.io');
        await page.screenshot({ path: `${browserType}.png` });
        await browser.close();
    }
})();
```

E é isso! Você integrou com sucesso os proxies Oxylabs com o Playwright. Se quiser saber mais sobre web scraping com o Playwright, leia nosso [post no blog](https://oxylabs.io/blog/playwright-web-scraping).

Encontre o post original do blog de integração do Playwright [aqui](https://oxylabs.io/resources/integrations/playwright).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/integrations/pt-br/proxy-integrations/playwright.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.