Эмуляция разрешений браузера

Puppeteer предоставляет широкие возможности для автоматизации тестирования веб-приложений, включая работу с браузером на уровне взаимодействия с его разрешениями. Эмуляция разрешений браузера необходима для симуляции различных условий, таких как разрешения на доступ к камере, микрофону, геолокации или уведомлениям, что позволяет тестировать реакции веб-страниц на изменения этих параметров.

Работа с разрешениями в браузере

В реальных условиях браузеры часто требуют разрешение пользователя для выполнения определённых действий, таких как доступ к камере или геолокации. В автоматизированных тестах с использованием Puppeteer важно эмулировать эти действия, чтобы проверять корректность работы приложений в таких ситуациях.

Puppeteer предоставляет механизм для работы с разрешениями, позволяя изменять их на уровне сессии. Для этого используется метод browserContext.overridePermissions, который позволяет задать нужные разрешения для указанного URL.

Настройка разрешений

Для того чтобы изменить разрешения, необходимо создать контекст браузера и использовать метод overridePermissions для нужного URL. Этот метод принимает два параметра:

  1. URL-адрес, для которого будут применяться разрешения.
  2. Массив разрешений, которые нужно предоставить или отклонить.

Пример настройки разрешений: 

const puppeteer = require(&

(async () => {
  const browser = await puppeteer.launch();
  const context = await browser.createIncognitoBrowserContext();

  // Эмуляция разрешений для геолокации
  await context.overridePermissions('https://example.com', ['geolocation']);

  const page = await context.newPage();
  await page.goto('https://example.com');

  // Тут можно продолжить тестирование, проверяя доступ к геолокации

  await browser.close();
})();

В этом примере создаётся инкогнито-контекст, для которого эмулируется разрешение на использование геолокации для сайта https://example.com.

Поддерживаемые разрешения

Puppeteer поддерживает несколько типов разрешений, которые можно эмулировать:

  1. geolocation — доступ к геолокации устройства.
  2. notifications — доступ к отправке уведомлений.
  3. camera — доступ к камере устройства.
  4. microphone — доступ к микрофону устройства.
  5. fullscreen — разрешение на переход в полноэкранный режим.
  6. push — разрешение на пуш-уведомления.

Для каждого из этих типов разрешений необходимо явно указывать разрешение или запрет. Важно помнить, что для каждого типа разрешения есть два состояния: разрешение (например, granted) или отказ (например, denied).

Пример использования: 

await context.overridePermissions('https://example.com', [
  'geolocation', 
  'notifications'
]);

В данном случае для страницы https://example.com будут предоставлены разрешения на использование геолокации и уведомлений.

Установка разрешений для отдельных тестов

Для некоторых тестов может быть необходимо эмулировать отказ от разрешений. Это можно сделать, установив значение denied вместо granted для соответствующих разрешений.

Пример отказа от разрешения на использование геолокации: 

await context.overridePermissions('https://example.com', [
  { name: 'geolocation', state: 'denied' }
]);

С помощью такого подхода можно точно настроить поведение тестируемого приложения в условиях отказа от разрешений, что особенно полезно для проверки корректной работы интерфейсов с учётом пользовательских предпочтений.

Сценарии использования

  1. Тестирование доступности геолокации. Использование геолокации на веб-страницах часто применяется для предоставления пользовательских услуг в зависимости от местоположения. Эмуляция разрешений для геолокации позволяет тестировать корректность работы таких функций без необходимости физически менять местоположение устройства.

  2. Тестирование работы с камерой и микрофоном. Веб-приложения, использующие медиа-ресурсы, должны корректно обрабатывать запросы на разрешения для доступа к камере или микрофону. Эмуляция этих разрешений помогает автоматизировать тестирование, избегая необходимости вручную предоставлять разрешения при каждом запуске теста.

  3. Проверка реакций на отказ от разрешений. Важно протестировать, как веб-приложение реагирует, если пользователь отклоняет запросы на разрешение. Эмуляция отказа от разрешений с помощью Puppeteer позволяет уверенно проводить такие тесты, проверяя, как страницы ведут себя в случае ошибок доступа.

Пример работы с несколькими разрешениями

Часто на веб-страницах используется несколько типов разрешений одновременно. Puppeteer позволяет комбинировать различные разрешения для одного URL. Для этого достаточно передать массив объектов с разными типами разрешений. 

await context.overridePermissions('https://example.com', [
  { name: 'geolocation', state: 'granted' },
  { name: 'camera', state: 'denied' }
]);

В этом примере сайт получает разрешение на использование геолокации, но доступ к камере будет заблокирован. Это помогает в симуляции разных ситуаций в реальных условиях.

Важные замечания

  • Инкогнито-режим: При изменении разрешений через Puppeteer важно помнить, что контексты браузера (например, инкогнито) могут иметь свои особенности в плане хранения и использования разрешений.

  • Международные ограничения: Некоторые разрешения могут быть ограничены на уровне страны или региона, что следует учитывать при проведении тестов, ориентированных на международную аудиторию.

  • Особенности браузеров: Разные браузеры могут по-разному обрабатывать разрешения и их эмуляцию. Важно тестировать на нескольких браузерах, чтобы избежать неожиданных результатов.

Эмуляция разрешений браузера в Puppeteer — это мощный инструмент для тестирования работы веб-приложений в разных сценариях. Умение правильно настроить разрешения позволяет создавать более устойчивые и надёжные автоматизированные тесты, проверяя не только функциональность, но и корректность поведения интерфейсов при взаимодействии с пользовательскими разрешениями.

Оглавление