====== Кукловодческая документация ======

===== Overview =====

Кукловод-это библиотека Node,предоставляющая высокоуровневый API для управления Chromium или Chrome по протоколу DevTools.

Кукловодный API является иерархическим и отражает структуру браузера.

> **ПРИМЕЧАНИЕ** На следующей диаграмме выцветшие объекты в настоящее время не представлены в Puppeteer. 
{{:nodejs:библиотеки:puppeteer:2.png?600x600|}}

  * ''[[#class-puppeteer|Puppeteer]]'' общается с браузером с[[https://chromedevtools.github.io/devtools-protocol/|помощью протокола DevTools]] .
  * ''[[#class-browser|Browser]]'' Экземпляр браузера может владеть несколькими контекстами браузера.
  * ''[[#class-browsercontext|BrowserContext]]'' Экземпляр BrowserContext определяет сеанс просмотра и может владеть несколькими страницами.
  * ''[[#class-page|Page]]'' имеет хотя бы один фрейм: основной фрейм. Могут быть и другие фреймы, созданныетегами[[https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe|iframe]] или[[https://developer.mozilla.org/en-US/docs/Web/HTML/Element/frame|frame]] .
  * ''[[#class-frame|Frame]]'' имеет по крайней мере один контекст выполнения - контекст выполнения по умолчанию, в котором выполняется JavaScript фрейма. Фрейм может иметь дополнительные контексты выполнения, связанные с[[https://developer.chrome.com/extensions|расширениями]] .
  * ''[[#class-worker|Worker]]'' имеет единый контекст выполнения и облегчает взаимодействие с[[https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API|WebWorkers]] .

(Источник схемы: [[https://docs.google.com/drawings/d/1Q_AM6KYs9kbyLZF-Lpp5mtpAWth73Cq8IKCsWYgi8MM/edit?usp=sharing|ссылка]] )

===== кукловод против кукловода-ядро =====

В каждом выпуске начиная с версии 1.7.0 мы публикуем два пакета:

  * [[https://www.npmjs.com/package/puppeteer|puppeteer]]
  * [[https://www.npmjs.com/package/puppeteer-core|puppeteer-core]]

''puppeteer'' - это продукт для автоматизации браузера. После установки он загружает версию Chromium, которую затем запускает с помощью ''puppeteer-core'' . Являясь продуктом для конечного пользователя, ''puppeteer'' поддерживает набор удобных переменных ''PUPPETEER%%_*%%'' env для настройки его поведения.

''puppeteer-core'' - это библиотека, которая помогает управлять всем, что поддерживает протокол DevTools. ''puppeteer-core'' не загружает Chromium при установке. Будучи библиотекой, ''puppeteer-core'' полностью управляется своим программным интерфейсом и игнорирует все переменные ''PUPPETEER%%_*%%'' env.

Подводя итог, единственные различия между ''puppeteer-core'' ''puppeteer'' и кукловодом заключаются в следующем:

  * ''puppeteer-core'' не загружает Chromium автоматически при установке.
  * ''puppeteer-core'' игнорирует все переменные ''PUPPETEER%%_*%%'' env.

В большинстве случаев вы будете в порядке с пакетом ''puppeteer'' .

Однако вы должны использовать ''puppeteer-core'' если:

  * вы создаете другой продукт или библиотеку для конечных пользователей на основе протокола DevTools. Например, можно создать генератор PDF ''puppeteer-core'' файлов с использованием puppeteer-core и написать собственный сценарий ''install.js'' , который загружает ''[[https://chromium.googlesource.com/chromium/src/+/lkgr/headless/README.md|headless_shell]]'' вместо Chromium для экономии места на диске.
  * вы связываете Puppeteer для использования в Chrome Extension/браузер с протоколом DevTools,где загрузка дополнительного двоичного Chromium ненужна.
  * вы создаете набор инструментов, одним из компонентов которого является ''puppeteer-core'' , и вы хотите отложить выполнение скрипта ''install.js'' до тех пор, пока не будет использован Chromium.

При использовании ''puppeteer-core'' не забудьте изменить строку include :

<code javascript>
const puppeteer = require('puppeteer-core');
</code>

Затем вам нужно будет вызвать ''[[#puppeteerconnectoptions|puppeteer.connect([options])]]'' или ''[[#puppeteerlaunchoptions|puppeteer.launch([options])]]'' с явной опцией ''executablePath'' .

===== Переменные среды =====

Кукловод ищет определенные [[https://en.wikipedia.org/wiki/Environment_variable|переменные среды,]] чтобы помочь в его работе. Если Puppeteer не находит их в среде на этапе установки, будет использоваться вариант этих переменных в нижнем регистре из [[https://docs.npmjs.com/cli/config|конфигурации npm]] .

  * ''HTTP_PROXY'' , ''HTTPS_PROXY'' , ''NO_PROXY'' - определяет настройки прокси HTTP, которые используются для загрузки и запуска Chromium.
  * ''PUPPETEER_SKIP_CHROMIUM_DOWNLOAD'' - не загружать Chromium в комплекте на этапе установки.
  * ''PUPPETEER_DOWNLOAD_HOST'' - перезаписать префикс URL-адреса, который используется для загрузки Chromium. Примечание: это включает протокол и может даже включать префикс пути. По умолчанию ''https://storage.googleapis.com'' .
  * ''PUPPETEER_DOWNLOAD_PATH'' - перезаписать путь к папке загрузок. По умолчанию ''<root>/.local-chromium'' , где ''<root>'' - корень пакета кукловода.
  * ''PUPPETEER_CHROMIUM_REVISION'' - укажите определенную версию Chromium, которую вы хотите использовать в Puppeteer. См. [[#puppeteerlaunchoptions|Puppeteer.launch ([параметры])]] о том, как определяется путь к исполняемому файлу. **ВНИМАНИЕ** : Puppeteer [[https://github.com/puppeteer/puppeteer/#q-why-doesnt-puppeteer-vxxx-work-with-chromium-vyyy|гарантированно работает только]] с поставляемым Chromium, используйте его на свой страх и риск.
  * ''PUPPETEER_EXECUTABLE_PATH'' - укажите путь к исполняемому файлу, который будет использоваться в ''puppeteer.launch'' . См. [[#puppeteerlaunchoptions|Puppeteer.launch ([параметры])]] о том, как определяется путь к исполняемому файлу. **ВНИМАНИЕ** : Puppeteer [[https://github.com/puppeteer/puppeteer/#q-why-doesnt-puppeteer-vxxx-work-with-chromium-vyyy|гарантированно работает только]] с поставляемым Chromium, используйте его на свой страх и риск.
  * ''PUPPETEER_PRODUCT'' - укажите, какой браузер вы хотите использовать в Puppeteer. Должен быть ''chrome'' или ''firefox'' . Это также можно использовать во время установки для получения рекомендованного двоичного файла браузера. Программная установка ''product'' в [[#puppeteerlaunchoptions|puppeteer.launch ([options])]] заменяет эту переменную среды. Товар выставлен в ''[[#puppeteerproduct|puppeteer.product]]''

> **ПРИМЕЧАНИЕ.** Переменные env PUPPETEER_ * не учитываются в пакете ''[[https://www.npmjs.com/package/puppeteer-core|puppeteer-core]]'' . 

===== Работа с хромированными удлинителями =====

Кукловод может быть использован для тестирования хромированных удлинителей.

> **ПРИМЕЧАНИЕ.** Расширения в Chrome / Chromium в настоящее время работают только в режиме без головы. 

Ниже приведен код для получения дескриптора [[https://developer.chrome.com/extensions/background_pages|фоновой страницы]] расширения, источник которого находится в ''./my-extension'' :

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const pathToExtension = require('path').join(__dirname, 'my-extension');
  const browser = await puppeteer.launch({
    headless: false,
    args: [
      `--disable-extensions-except=${pathToExtension}`,
      `--load-extension=${pathToExtension}`
    ]
  });
  const targets = await browser.targets();
  const backgroundPageTarget = targets.find(target => target.type() === 'background_page');
  const backgroundPage = await backgroundPageTarget.page();
  // Тестируем фоновую страницу так же, как и любую другую страницу.
  await browser.close();
})();
</code>

> **ПРИМЕЧАНИЕ.** Пока невозможно протестировать всплывающие окна расширений или сценарии содержимого. 

===== Класс:Кукловод =====

Модуль "Кукловод" предоставляет способ запуска экземпляра Chromium.Ниже приведен типичный пример использования кукловода для автоматизации:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://www.google.com');
  // другие действия...
  await browser.close();
})();
</code>

==== puppeteer.clearCustomQueryHandlers() ====

Очищает все зарегистрированные обработчики.

==== puppeteer.connect(options) ====

    * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''browserWSEndpoint'' %%<?%% [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] %%>%% [[#browserwsendpoint|конечная точка веб-сокета браузера]] для подключения.
    * ''browserURL'' %%<?%% [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] %%>%% URL-адрес браузера, к которому нужно подключиться, в формате ''%%http://${host}:${port}%%'' . Используйте взаимозаменяемо с ''browserWSEndpoint'' , чтобы позволить Puppeteer получить его из [[https://chromedevtools.github.io/devtools-protocol/#how-do-i-access-the-browser-target|конечной точки метаданных]] .
    * ''ignoreHTTPSErrors'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Следует ли игнорировать ошибки HTTPS во время навигации. По умолчанию - ''false'' .
    * ''defaultViewport'' %%<?%% [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] %%>%% Устанавливает согласованное окно просмотра для каждой страницы. По умолчанию используется область просмотра 800x600. ''null'' отключает область просмотра по умолчанию.
    * ''width'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > ширина страницы в пикселях.
    * ''height'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > высота страницы в пикселях.
    * ''deviceScaleFactor'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Определяет масштабный коэффициент устройства (можно рассматривать как dpr). По умолчанию ''1'' .
    * ''isMobile'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Учитывается ли ''meta viewport'' . По умолчанию - ''false'' .
    * ''hasTouch'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, поддерживает ли область просмотра события касания. По умолчанию ''false''
    * ''isLandscape'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, находится ли область просмотра в альбомном режиме. По умолчанию - ''false'' .
    * ''slowMo'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Замедляет операции Puppeteer на указанное количество миллисекунд. Полезно, чтобы вы могли видеть, что происходит.
    * ''transport'' < [[https://github.com/puppeteer/puppeteer/blob/v7.1.0/src/WebSocketTransport.js|ConnectionTransport]] > **Experimental** Укажите пользовательский объект транспорта, который будет использовать Puppeteer.
    * ''product'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Возможные значения: ''chrome'' , ''firefox'' . По умолчанию ''chrome'' .
    * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-browser|Browser]] >>

Этот метод присоединяет Puppeteer к существующему экземпляру браузера.

==== puppeteer.createBrowserFetcher%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
  * ''host'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Используемый хост загрузки. По умолчанию ''https://storage.googleapis.com'' . Если ''product'' является ''firefox'' , это по умолчанию ''https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-  central'' .
  * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Путь к папке загрузок. По умолчанию ''<root>/.local-chromium'' , где ''<root>'' - корень пакета кукловода. Если ''product'' - ''firefox'' , по умолчанию используется ''<root>/.local-firefox'' .
    * ''platform'' <"linux" | "mac" | "win32" | "win64"> [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] для текущей платформы. Возможные значения: ''mac'' , ''win32'' , ''win64'' , ''linux'' . По умолчанию используется текущая платформа.
    * ''product'' <"chrome" | "firefox"> [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] для запуска продукта. Возможные значения: ''chrome'' , ''firefox'' . По умолчанию ''chrome'' .
    * возвращает: < [[#class-browserfetcher|BrowserFetcher]] >

==== puppeteer.customQueryHandlerNames() ====

    * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] > Список с именами всех зарегистрированных обработчиков пользовательских запросов.

==== puppeteer.defaultArgs%%([%%options]) ====

    * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Набор настраиваемых параметров для настройки в браузере. Могут иметь следующие поля:
    * ''headless'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Следует ли запускать браузер в [[https://developers.google.com/web/updates/2017/04/headless-chrome|автономном режиме]] . По умолчанию ''true'' , если опция ''devtools'' не ''true'' .
    * ''args'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Дополнительные аргументы для передачи экземпляру браузера. Список флагов Chromium можно найти [[http://peter.sh/experiments/chromium-command-line-switches/|здесь]] .
    * ''userDataDir'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Путь к каталогу [[https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md|пользовательских данных]] .
    * ''devtools'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Следует ли автоматически открывать панель DevTools для каждой вкладки. Если эта опция ''true'' , опция ''headless'' будет установлена ''false'' .
    * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Массив]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >>

Флаги по умолчанию,с которыми будет запущен Chromium.

==== puppeteer.devices ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >

Возвращает список устройств, которые будут использоваться с ''[[#pageemulateoptions|page.emulate(options)]]'' . Актуальный список устройств можно найти в ''[[https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts|src/common/DeviceDescriptors.ts]]'' .

<code javascript>
const puppeteer = require('puppeteer');
const iPhone = puppeteer.devices['iPhone 6'];

(async () => {
   const browser = await puppeteer.launch();
   const page = await browser.newPage();
   await page.emulate(iPhone);
   await page.goto('https://www.google.com');
   // другие действия...
   await browser.close();
})();
</code>

==== puppeteer.errors ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >
  * ''TimeoutError'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] > Класс [[#class-timeouterror|TimeoutError]] .

Методы кукловода могут вызывать ошибки, если они не могут выполнить запрос. Например, [[#pagewaitforselectorselector-options|page.waitForSelector (selector [, options])]] может завершиться ошибкой, если селектор не соответствует ни одному узлу в течение заданного периода времени.

Для определенных типов ошибок Puppeteer использует определенные классы ошибок. Эти классы доступны через ''[[#puppeteererrors|puppeteer.errors]]''[[#puppeteererrors| .]]

Пример обработки ошибки таймаута:

<code javascript>
try {
  await page.waitForSelector('.foo');
} catch (e) {
  if (e instanceof puppeteer.errors.TimeoutError) {
        // Do something if this is a timeout.
  }
}
</code>

> **ПРИМЕЧАНИЕ** Старый способ (версии Puppeteer <= v1.14.0) можно получить с помощью ''require%%('%%puppeteer/Errors')'' .

==== puppeteer.executablePath() ====

    * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Путь, по которому Puppeteer ожидает найти связанный браузер. Двоичный файл браузера может отсутствовать, если загрузка была пропущена с помощью ''[[#environment-variables|PUPPETEER_SKIP_DOWNLOAD]]'' .

> **ПРИМЕЧАНИЕ. На** ''puppeteer.executablePath()'' влияют переменные ''PUPPETEER_EXECUTABLE_PATH'' и ''PUPPETEER_CHROMIUM_REVISION'' . См. Подробности в разделе « [[#environment-variables|Переменные среды»]] .

==== puppeteer.launch%%([%%options]) ====

    * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Набор настраиваемых параметров для настройки в браузере. Могут иметь следующие поля:
    * ''product'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Какой браузер запускать. На данный момент это либо ''chrome'' либо ''firefox'' . См. Также ''PUPPETEER_PRODUCT'' .
    * ''ignoreHTTPSErrors'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Следует ли игнорировать ошибки HTTPS во время навигации. По умолчанию - ''false'' .
    * ''headless'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Следует ли запускать браузер в [[https://developers.google.com/web/updates/2017/04/headless-chrome|автономном режиме]] . По умолчанию ''true'' , если опция ''devtools'' не ''true'' .
    * ''executablePath'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Путь к исполняемому файлу браузера, который нужно запустить вместо связанного Chromium. Если ''executablePath'' путь является относительным путем, он разрешается относительно [[https://nodejs.org/api/process.html#process_process_cwd|текущего рабочего каталога]] . **ВНИМАНИЕ** : Puppeteer [[https://github.com/puppeteer/puppeteer/#q-why-doesnt-puppeteer-vxxx-work-with-chromium-vyyy|гарантированно работает только]] с поставляемым Chromium, используйте его на свой страх и риск.
    * ''slowMo'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Замедляет операции Puppeteer на указанное количество миллисекунд. Полезно, чтобы вы могли видеть, что происходит.
    * ''defaultViewport'' %%<?%% [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] %%>%% Устанавливает согласованное окно просмотра для каждой страницы. По умолчанию используется область просмотра 800x600. ''null'' отключает область просмотра по умолчанию.
    * ''width'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > ширина страницы в пикселях.
    * ''height'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > высота страницы в пикселях.
    * ''deviceScaleFactor'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Определяет масштабный коэффициент устройства (можно рассматривать как dpr). По умолчанию ''1'' .
    * ''isMobile'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Учитывается ли ''meta viewport'' . По умолчанию - ''false'' .
    * ''hasTouch'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, поддерживает ли область просмотра события касания. По умолчанию ''false''
    * ''isLandscape'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, находится ли область просмотра в альбомном режиме. По умолчанию - ''false'' .
    * ''args'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Дополнительные аргументы для передачи экземпляру браузера. Список флагов Chromium можно найти [[http://peter.sh/experiments/chromium-command-line-switches/|здесь]] , а вот список [[https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options|флагов Firefox]] .
    * ''ignoreDefaultArgs'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Если ''true'' , то не используйте ''[[#puppeteerdefaultargsoptions|puppeteer.defaultArgs()]]'' . Если дан массив, отфильтруйте заданные аргументы по умолчанию. Опасный вариант; используйте с осторожностью. По умолчанию - ''false'' .
    * ''handleSIGINT'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Закройте процесс браузера, нажав Ctrl-C. По умолчанию ''true'' .
    * ''handleSIGTERM'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Закройте процесс браузера на SIGTERM. По умолчанию ''true'' .
    * ''handleSIGHUP'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Закройте процесс браузера по SIGHUP. По умолчанию ''true'' .
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время ожидания в миллисекундах запуска экземпляра браузера. По умолчанию ''30000'' (30 секунд). Передайте ''0'' , чтобы отключить тайм-аут.
    * ''dumpio'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Передавать ли браузерный процесс stdout и stderr по конвейеру в ''process.stdout'' и ''process.stderr'' . По умолчанию - ''false'' .
    * ''userDataDir'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Путь к каталогу [[https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md|пользовательских данных]] .
    * ''env'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Укажите переменные среды, которые будут видны браузеру. По умолчанию ''process.env'' .
    * ''devtools'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Следует ли автоматически открывать панель DevTools для каждой вкладки. Если эта опция ''true'' , опция ''headless'' будет установлена ''false'' .
    * ''pipe'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Подключается к браузеру через канал вместо WebSocket. По умолчанию - ''false'' .
    * ''extraPrefsFirefox'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Дополнительные [[https://developer.mozilla.org/en-US/docs/Mozilla/Preferences/Preference_reference|настройки,]] которые можно передать Firefox (см. ''PUPPETEER_PRODUCT'' )
    * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-browser|Browser]] >> Promise, которое разрешается экземпляру браузера.

Вы можете использовать ''ignoreDefaultArgs'' , чтобы отфильтровать ''--mute-audio'' из аргументов по умолчанию:

<code javascript>
const browser = await puppeteer.launch({
   ignoreDefaultArgs: ['--mute-audio']
});
</code>

> **ПРИМЕЧАНИЕ** Puppeteer также можно использовать для управления браузером Chrome, но лучше всего он работает с версией Chromium, с которой он связан. Нет никаких гарантий, что он будет работать с любой другой версией. С особой осторожностью используйте параметр ''executablePath'' . Если предпочтение отдается Google Chrome (а не Chromium), рекомендуется сборка [[https://www.google.com/chrome/browser/canary.html|Chrome Canary]] или [[https://www.chromium.org/getting-involved/dev-channel|Dev Channel]] . В приведенном выше [[#puppeteerlaunchoptions|puppeteer.launch ([options])]] любое упоминание Chromium также относится к Chrome. См. В ''[[https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/|this article]]'' описание различий между Chromium и Chrome. ''[[https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md|This article]]'' описаны некоторые отличия для пользователей Linux.

==== puppeteer.networkConditions ====

* возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >

Возвращает список сетевых условий, которые будут использоваться с ''[[#pageemulatenetworkconditionsnetworkconditions|page.emulateNetworkConditions(networkConditions)]]'' . Актуальный список условий можно найти в ''[[https://github.com/puppeteer/puppeteer/blob/main/src/common/NetworkConditions.ts|src/common/NetworkConditions.ts]]'' .

<code javascript>
const puppeteer = require('puppeteer');
const slow3G = puppeteer.networkConditions['Slow 3G'];

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.emulateNetworkConditions(slow3G);
  await page.goto('https://www.google.com');
  // другие действия...
  await browser.close();
})();
</code>

==== puppeteer.product ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > возвращает имя браузера, который находится в автоматическом режиме ( ''"chrome"'' или ''"firefox"'' )

Продукт устанавливается переменной среды ''PUPPETEER_PRODUCT'' или параметром ''product'' в [[#puppeteerlaunchoptions|puppeteer.launch ([options])]] и по умолчанию используется ''chrome'' . Поддержка Firefox является экспериментальной и требует установки Puppeteer через ''PUPPETEER_PRODUCT=firefox npm i puppeteer'' .

==== puppeteer.registerCustomQueryHandler(name, queryHandler) ====

  * ''name'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Имя, под которым будет зарегистрирован пользовательский обработчик запросов.
  * ''queryHandler'' < [[#interface-customqueryhandler|CustomQueryHandler]] > [[#interface-customqueryhandler|Пользовательский обработчик запросов]] для регистрации.

Регистрирует [[#interface-customqueryhandler|пользовательский обработчик запросов]] . После регистрации обработчик можно использовать везде, где ожидается селектор, добавив перед строкой выбора ''<name>/'' . Имя может состоять только из строчных и прописных латинских букв.

Example:

<code javascript>
puppeteer.registerCustomQueryHandler('getByClass', {
   queryOne: (element, selector) => {
        return element.querySelector(`.${selector}`);
    },
   queryAll: (element, selector) => {
        return element.querySelectorAll(`.${selector}`);
    },
});
const aHandle = await page.$('getByClass/…');
</code>

==== puppeteer.unregisterCustomQueryHandler(name) ====

        * ''name'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Имя обработчика запроса, регистрацию которого нужно отменить.

===== Класс:BrowserFetcher =====

BrowserFetcher может загружать и управлять различными версиями Chromium и Firefox.

BrowserFetcher работает со строками ревизий, которые указывают точную версию Chromium, например, ''"533271"'' . Строки редакции можно получить на сайте [[https://omahaproxy.appspot.com/|omahaproxy.appspot.com]] .

В случае с Firefox BrowserFetcher загружает Firefox Nightly и работает с такими номерами версий, как ''"75"'' .

Пример использования BrowserFetcher для загрузки определенной версии Chromium и запуска Кукловода против нее:

<code javascript>
const browserFetcher = puppeteer.createBrowserFetcher();
const revisionInfo = await browserFetcher.download('533271');
const browser = await puppeteer.launch({executablePath: revisionInfo.executablePath})
</code>

> **ПРИМЕЧАНИЕ** BrowserFetcher не предназначен для одновременной работы с другими экземплярами BrowserFetcher, которые используют тот же каталог загрузок.

==== browserFetcher.canDownload(revision) ====

  * ''revision'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > ревизия для проверки доступности.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] >> возвращает ''true'' , если ревизия может быть загружена с хоста.

Метод инициирует запрос HEAD для проверки доступности ревизии.

==== browserFetcher.download(revision[,progressCallback]). ====

        * ''revision'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > версия для загрузки.
        * ''progressCallback'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] , [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] )> Функция, которая будет вызываться с двумя аргументами:
        * ''downloadedBytes'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > сколько байтов было загружено
        * ''totalBytes'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > насколько велика общая загрузка.
        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Разрешается с информацией о ревизии, когда ревизия загружается и извлекается
        * ''revision'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > ревизия, из которой была создана информация
        * ''folderPath'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > путь к извлеченной папке ревизии
        * ''executablePath'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > путь к исполняемому файлу редакции
        * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > URL, с которого можно скачать эту версию
        * ''local'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] >, доступна ли ревизия локально на диске

Метод инициирует GET-запрос на загрузку ревизии с хоста.

==== browserFetcher.host() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Используемый хост загрузки.

==== browserFetcher.localRevisions() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >>> Список всех ревизий (для текущего ''product'' ), доступных локально на диске.

==== browserFetcher.platform() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Один из ''mac'' , ''linux'' , ''win32'' или ''win64'' .

==== browserFetcher.product() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Один из ''chrome'' или ''firefox'' .

==== browserFetcher.remove(revision) ====

        * ''revision'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > ревизия, которую нужно удалить для текущего ''product'' . Метод сгенерирует, если ревизия не была загружена.
        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Устраняет, когда ревизия была удалена.

==== browserFetcher.revisionInfo(revision) ====

   * ''revision'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > версия, для которой нужно получить информацию.
   * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >
   * ''revision'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > ревизия, из которой была создана информация
   * ''folderPath'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > путь к извлеченной папке ревизии
   * ''executablePath'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > путь к исполняемому файлу редакции
   * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > URL, с которого можно скачать эту версию
   * ''local'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] >, доступна ли ревизия локально на диске
   * ''product'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > один из ''chrome'' или ''firefox''

> **ПРИМЕЧАНИЕ.** Многие методы BrowserFetcher, такие как ''remove'' и ''revisionInfo'' , зависят от выбора ''product'' . См. [[#puppeteercreatebrowserfetcheroptions|Puppeteer.createBrowserFetcher ([параметры])]] .

===== Класс:Браузер =====

  * extends: [[#class-eventemitter|EventEmitter]]

Браузер создается, когда Puppeteer подключается к экземпляру Chromium через ''[[#puppeteerlaunchoptions|puppeteer.launch]]'' или ''[[#puppeteerconnectoptions|puppeteer.connect]]'' .

Пример использования [[#class-browser|браузера]] для создания [[#class-page|страницы]] :

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
   const browser = await puppeteer.launch();
   const page = await browser.newPage();
   await page.goto('https://example.com');
   await browser.close();
})();
</code>

Пример отключения от [[#class-browser|браузера]] и повторного подключения к нему :

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  // Сохраняем конечную точку, чтобы иметь возможность повторно подключиться к Chromium
  const browserWSEndpoint = browser.wsEndpoint();
  // Отключить кукловода от Chromium
  browser.disconnect();

  // Использование конечной точки для восстановления соединения
  const browser2 = await puppeteer.connect({browserWSEndpoint});
  // Закрываем Chromium
  await browser2.close();
})();
</code>

==== Событие:"разъединённый ====

Используется,когда кукловод отключается от экземпляра Chromium.Это может произойти из-за одного из следующих моментов:

  * Хром закрыт или разбился
  * ''[[#browserdisconnect|browser.disconnect]]'' метод был назван

==== Событие:"изменённая мишень ====

  * <[[#class-target|Target]]>

Испускается,когда урна мишени меняется.

> **ПРИМЕЧАНИЕ.** Это включает целевые изменения в контексте браузера в режиме инкогнито.

==== Событие:"созданный мишенью ====

  * <[[#class-target|Target]]>

Испускается при создании цели, например, когда новая страница открывается с помощью ''[[https://developer.mozilla.org/en-US/docs/Web/API/Window/open|window.open]]'' или ''[[#browsernewpage|browser.newPage]]'' .

> **ПРИМЕЧАНИЕ.** Это включает создание целевых объектов в контексте браузера в режиме инкогнито.

==== Событие:"уничтоженный мишенью ====

  * <[[#class-target|Target]]>

Используется,когда цель уничтожена,например,при закрытии страницы.

> **ПРИМЕЧАНИЕ.** Сюда входят целевые разрушения в контексте браузера в режиме инкогнито.

==== browser.browserContexts() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-browsercontext|BrowserContext]] >>

Возвращает массив всех открытых контекстов браузера. Во вновь созданном браузере это вернет единственный экземпляр [[#class-browsercontext|BrowserContext]] .

==== browser.close() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Закрывает Chromium и все его страницы (если таковые были открыты). Сам объект [[#class-browser|Browser]] считается удаленным и больше не может использоваться.

==== browser.createIncognitoBrowserContext() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-browsercontext|BrowserContext]] >>

Создает новый контекст браузера инкогнито.Это не будет совместно использовать куки/кэш с другими контекстами браузера.

<code javascript>
(async () => {
  const browser = await puppeteer.launch();
  // Создаем новый контекст браузера в режиме инкогнито.
  const context = await browser.createIncognitoBrowserContext();
  // Создаем новую страницу в безупречном контексте.
  const page = await context.newPage();
  // Делаем что-нибудь
  await page.goto('https://example.com');
})();
</code>

==== browser.defaultBrowserContext() ====

        * возвращает: < [[#class-browsercontext|BrowserContext]] >

Возвращает контекст браузера по умолчанию.Контекст браузера по умолчанию не может быть закрыт.

==== browser.disconnect() ====

Отключает Puppeteer от браузера, но оставляет процесс Chromium запущенным. После вызова ''disconnect'' , то [[#class-browser|браузер]] объект считается настроенным и не может больше использоваться.

==== browser.isConnected() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >

Указывает на то,что браузер подключен.

==== browser.newPage() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] < [[#class-page|Страница]] >>

Обещание, которое преобразуется в новый объект [[#class-page|Page]] . [[#class-page|Страница]] создана в контексте браузера по умолчанию.

==== browser.pages() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-page|Page]] >>> Promise, который преобразуется в массив всех открытых страниц. Невидимые страницы, такие как ''"background_page"'' , здесь не отображаются. Вы можете найти их с помощью [[#targetpage|target.page ()]] .

Массив всех страниц внутри Браузера.В случае нескольких контекстов браузера,метод вернет массив со всеми страницами во всех контекстах браузера.

==== browser.process() ====

        * возвращает: %%<?%% [[https://nodejs.org/api/child_process.html|ChildProcess]] %%>%% Созданный процесс браузера. Возвращает ''null'' , если экземпляр браузера был создан с помощью метода ''[[#puppeteerconnectoptions|puppeteer.connect]]'' .

==== browser.target() ====

        * возвращает: < [[#class-target|Target]] >

Цель,связанная с браузером.

==== browser.targets() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-target|Target]] >>

Массив всех активных целей внутри Браузера.В случае нескольких контекстов браузера,метод вернет массив со всеми целями во всех контекстах браузера.

==== browser.userAgent() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Promise, которое преобразуется в исходный пользовательский агент браузера.

> **ПРИМЕЧАНИЕ** Pages могут переопределить пользовательский агент браузера с помощью [[#pagesetuseragentuseragent|page.setUserAgent.]]

==== browser.version() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Для безголового Chromium это похоже на ''HeadlessChrome/61.0.3153.0'' . Для пользователей без головы это похоже на ''Chrome/61.0.3153.0'' .

> **ПРИМЕЧАНИЕ** формат browser.version () может измениться в будущих выпусках Chromium.

==== browser.waitForTarget(предикат[,опции]). ====

  * ''predicate'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[#class-target|Target]] ): [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Функция, запускаемая для каждой цели
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
  * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время ожидания в миллисекундах. Передайте ''0'' , чтобы отключить тайм-аут. По умолчанию 30 секунд.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-target|Target]] >> Promise, которое преобразуется в первую найденную цель, соответствующую функции ''predicate'' .

При этом осуществляется поиск цели во всех контекстах браузера.

Пример поиска цели для страницы, открытой через ''window.open'' :

<code javascript>
await page.evaluate(() => window.open('https://www.example.com/'));
const newWindowTarget = await browser.waitForTarget(target => target.url() === 'https://www.example.com/');
</code>

==== browser.wsEndpoint() ====

        * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > URL-адрес веб-сокета браузера.

Конечная точка веб-сокета браузера, которую можно использовать в качестве аргумента для [[#puppeteerconnectoptions|puppeteer.connect]] . Формат: %%''ws:
//${host}:${port}/devtools/browser/<id>''%%

Вы можете найти ''webSocketDebuggerUrl'' по %%''http://${host}:${port}/json/version''%% . Узнайте больше о [[https://chromedevtools.github.io/devtools-protocol|протоколе devtools]] и [[https://chromedevtools.github.io/devtools-protocol/#how-do-i-access-the-browser-target|конечной точке браузера]] .

===== Класс:БраузерКонтекст =====

  * extends: [[#class-eventemitter|EventEmitter]]

BrowserContexts позволяют управлять несколькими независимыми сеансами браузера. Когда браузер запущен, по умолчанию используется один BrowserContext. Метод ''browser.newPage()'' создает страницу в контексте браузера по умолчанию.

Если страница открывает другую страницу, например, с помощью вызова ''window.open'' , всплывающее окно будет принадлежать контексту браузера родительской страницы.

Puppeteer позволяет создавать контексты браузера «инкогнито» с помощью метода ''browser.createIncognitoBrowserContext()'' . Контексты браузера "инкогнито" не записывают данные просмотра на диск.

<code javascript>
// Создаем новый контекст браузера в режиме инкогнито
const context = await browser.createIncognitoBrowserContext();
// Создаем новую страницу внутри контекста.
const page = await context.newPage();
// ... что-то делать со страницей ...
await page.goto('https://example.com');
// Удаляем контекст, когда он больше не нужен.
await context.close();
</code>

==== Событие:"изменённая мишень ====

  * <[[#class-target|Target]]>

Исполняется,когда изменяется url цели внутри контекста браузера.

==== Событие:"созданный мишенью ====

  * <[[#class-target|Target]]>

Излучается, когда в контексте браузера создается новая цель, например, когда новая страница открывается с помощью ''[[https://developer.mozilla.org/en-US/docs/Web/API/Window/open|window.open]]'' или ''[[#browsercontextnewpage|browserContext.newPage]]'' .

==== Событие:"уничтоженный мишенью ====

  * <[[#class-target|Target]]>

Используется,когда цель внутри контекста браузера уничтожена,например,при закрытии страницы.

==== browserContext.browser() ====

  * возвращает: < [[#class-browser|Браузер]] >

Браузер,к которому принадлежит этот контекст браузера.

==== browserContext.clearPermissionOverrides() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Очищает все переопределения разрешений для контекста браузера.

<code javascript>
const context = browser.defaultBrowserContext();
context.overridePermissions('https://example.com', ['clipboard-read']);
// делаем что-нибудь ..
context.clearPermissionOverrides();
</code>

==== browserContext.close() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Закрывает контекст браузера.Все цели,принадлежащие контексту браузера,будут закрыты.

> **ПРИМЕЧАНИЕ:** закрывать можно только контексты браузера в режиме инкогнито. 

==== browserContext.isIncognito() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >

Возвращает,является ли BrowserContext инкогнито.Контекст браузера по умолчанию является единственным контекстом браузера,не использующим инкогнито.

> **ПРИМЕЧАНИЕ:** контекст браузера по умолчанию не может быть закрыт. 

==== browserContext.newPage() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] < [[#class-page|Страница]] >>

Создает новую страницу в контексте браузера.

==== browserContext.overrideПолномочия (происхождение,разрешения) ====

  * ''origin'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Источник, [[https://developer.mozilla.org/en-US/docs/Glossary/Origin|которому]] нужно предоставить разрешения, например, " [[https://example.com|https://example.com]] ".
  * ''permissions'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Массив предоставляемых разрешений. Все разрешения, не перечисленные здесь, будут автоматически отклонены. Разрешения могут быть одним из следующих значений:
    * '''geolocation'''
    * '''midi'''
    * '''midi-sysex''' (системно-эксклюзивные midi)
    * '''notifications'''
    * '''push'''
    * '''camera'''
    * '''microphone'''
    * '''background-sync'''
    * '''ambient-light-sensor'''
    * '''accelerometer'''
    * '''gyroscope'''
    * '''magnetometer'''
    * '''accessibility-events'''
    * '''clipboard-read'''
    * '''clipboard-write'''
    * '''payment-handler'''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

<code javascript>
const context = browser.defaultBrowserContext();
await context.overridePermissions('https://html5demos.com', ['geolocation']);
</code>

==== browserContext.pages() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-page|Page]] >>> Promise, который преобразуется в массив всех открытых страниц. Невидимые страницы, такие как ''"background_page"'' , здесь не отображаются. Вы можете найти их с помощью [[#targetpage|target.page ()]] .

Массив всех страниц в контексте браузера.

==== browserContext.targets() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-target|Target]] >>

Массив всех активных целей в контексте браузера.

==== browserContext.waitForTarget(предикат[,опции]) ====

  * ''predicate'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[#class-target|Target]] ): [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Функция, запускаемая для каждой цели
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время ожидания в миллисекундах. Передайте ''0'' , чтобы отключить тайм-аут. По умолчанию 30 секунд.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-target|Target]] >> Promise, которое преобразуется в первую найденную цель, соответствующую функции ''predicate'' .

При этом выполняется поиск цели в данном конкретном контексте браузера.

Пример поиска цели для страницы, открытой через ''window.open'' :

<code javascript>
await page.evaluate(() => window.open('https://www.example.com/'));
const newWindowTarget = await browserContext.waitForTarget(target => target.url() === 'https://www.example.com/');
</code>

===== Класс:Страница =====

  * extends: [[#class-eventemitter|EventEmitter]]

Страница предоставляет методы для взаимодействия с одной вкладкой или [[https://developer.chrome.com/extensions/background_pages|фоновой страницей расширения]] в Chromium. Один экземпляр [[#class-browser|браузера]] может иметь несколько экземпляров [[#class-page|страницы]] .

В этом примере создается страница,осуществляется навигация по URL,а затем сохраняется снимок экрана:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await page.screenshot({path: 'screenshot.png'});
  await browser.close();
})();
</code>

Класс Page генерирует различные события (описанные ниже), которые можно обрабатывать с помощью любого из методов ''[[#class-eventemitter|EventEmitter]]'' , например ''on'' , ''once'' или ''off'' .

В этом примере регистрируется сообщение для события ''load'' одной страницы :

<code javascript>
page.once('load', () => console.log('Page loaded!'));
</code>

Чтобы отказаться от подписки на события, используйте метод ''off'' :

<code javascript>
function logRequest(interceptedRequest) {
  console.log('A request was made:', interceptedRequest.url());
}
page.on('request', logRequest);
// Немного позже...
page.off('request', logRequest);
</code>

==== Событие:"закрытие ====

Используется,когда страница закрывается.

==== Событие:"консоль ====

  * <[[#class-consolemessage|ConsoleMessage]]>

Генерируется, когда JavaScript на странице вызывает один из методов консольного API, например ''console.log'' или ''console.dir'' . Также выдается, если страница выдает ошибку или предупреждение.

Аргументы, переданные в ''console.log'' , появляются как аргументы в обработчике событий.

Пример обработки ''console'' события:

<code javascript>
page.on('console', msg => {
  for (let i = 0; i < msg.args().length; ++i)
    console.log(`${i}: ${msg.args()[i]}`);
});
page.evaluate(() => console.log('hello', 5, {foo: 'bar'}));
</code>

==== Событие:"диалог ====

  * <[[#class-dialog|Dialog]]>

Выдается при появлении диалогового окна JavaScript, например ''alert'' , ''prompt'' , ''confirm'' или ''beforeunload'' . Кукольник может ответить на диалог с помощью [[#class-dialog|Диалог]] «s [[#dialogacceptprompttext|принять]] или [[#dialogdismiss|отклонить]] методы.

==== Событие:"загруженный дом ====

Генерируется при ''[[https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded|DOMContentLoaded]]'' события JavaScript DOMContentLoaded .

==== Событие:"ошибка ====

  * <[[https://nodejs.org/api/errors.html#errors_class_error|Error]]>

Отправляется при сбое страницы.

> **ПРИМЕЧАНИЕ.** Событие ''error'' имеет особое значение в Node, подробности см. В разделе « [[https://nodejs.org/api/events.html#events_error_events|События ошибок»]] . 

==== Событие:"подкреплённый ====

  * <[[#class-frame|Frame]]>

Испускается,когда рама прикреплена.

==== Событие:"обрамлённый ====

  * <[[#class-frame|Frame]]>

Используется,когда рамка отсоединена.

==== Событие:"фрэмавигационный ====

  * <[[#class-frame|Frame]]>

Используется,когда рамка перемещается к новому урлу.

==== событие:"нагрузка ====

Генерируется при отправке события ''[[https://developer.mozilla.org/en-US/docs/Web/Events/load|load]]'' JavaScript .

==== Событие:"метрика ====

  * <[[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]]>
    * ''title'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Заголовок, переданный в ''console.timeStamp'' .
    * ''metrics'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Объект, содержащий метрики в виде пар ключ / значение. Значения показателей имеют тип < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >.

Генерируется, когда код JavaScript вызывает ''console.timeStamp'' . Список показателей см. На ''page.metrics'' .

==== событие:'пейджеррор ====

  * < [[https://nodejs.org/api/errors.html#errors_class_error|Ошибка]] > Сообщение об исключении

Выписывается,когда на странице происходит незамеченное исключение.

==== Событие:"всплытие ====

  * < [[#class-page|Страница]] > Страница, соответствующая «всплывающему» окну

Отменяется,когда страница открывает новую вкладку или окно.

<code javascript>
const [popup] = await Promise.all([
  new Promise(resolve => page.once('popup', resolve)),
  page.click('a[target=_blank]'),
]);
</code>

<code javascript>
const [popup] = await Promise.all([
  new Promise(resolve => page.once('popup', resolve)),
  page.evaluate(() => window.open('https://example.com')),
]);
</code>

==== Событие:"запрос ====

  * <[[#class-httprequest|HTTPRequest]]>

Выдается, когда страница выдает запрос. Объект [[#class-httprequest|HTTPRequest доступен]] только для чтения. Чтобы перехватить и ''page.setRequestInterception'' запросы, см. Page.setRequestInterception .

==== Событие:"отклонённый запрос ====

  * <[[#class-httprequest|HTTPRequest]]>

Используется,когда запрос не удается,например,по таймингу.

> **ПРИМЕЧАНИЕ.** Ответы HTTP Error, такие как 404 или 503, по-прежнему являются успешными ответами с точки зрения HTTP, поэтому запрос завершится с событием ''[[#event-requestfinished|'requestfinished']]'' а не с ''[[#event-requestfailed|'requestfailed']]'' . 

==== Событие:запрошенный ====

  * <[[#class-httprequest|HTTPRequest]]>

Выпущено при успешном завершении запроса.

==== Событие:"реакция ====

  * <[[#class-httpresponse|HTTPResponse]]>

Выдается при получении [[#class-httpresponse|HTTPResponse]] .

==== Событие:"созданный рабочими ====

  * <[[#class-webworker|WebWorker]]>

Выдается, когда на [[https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API|странице]] создается выделенный WebWorker .

==== Событие:"уничтоженный рабочими ====

  * <[[#class-webworker|WebWorker]]>

[[https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API|Выдается при]] завершении работы выделенного WebWorker .

==== page.$(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса страницы для
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-elementhandle|ElementHandle]] >>

Метод запускает ''document.querySelector'' на странице. Если ни один элемент не соответствует селектору, возвращаемое значение принимает значение ''null'' .

Ярлык для [[#frameselector|page.mainFrame (). $ (Селектор)]] .

==== page.$$(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса страницы для
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-elementhandle|ElementHandle]] >>>

Метод запускает ''document.querySelectorAll'' на странице. Если ни один элемент не соответствует селектору, возвращаемое значение преобразуется в ''[]'' .

Ярлык для [[#frameselector-1|page.mainFrame (). $$ (селектор)]] .

==== page.$$eval(селектор,функция pageFunction[,...args])) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса страницы для
  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/API/element|Element]] >)> Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Этот метод запускает ''Array.from(document.querySelectorAll(selector))'' на странице и передает его в качестве первого аргумента ''pageFunction'' .

Если ''pageFunction'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|обещание]] , то ''page.$$eval'' будет ждать разрешения обещания и вернет его значение.

Examples:

<code javascript>
const divCount = await page.$$eval('div', divs => divs.length);
</code>

<code javascript>
const options = await page.$$eval('div > span.options', options => options.map(option => option.textContent));
</code>

==== page.$eval(селектор,pageFunction[,...args])) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса страницы для
  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[https://developer.mozilla.org/en-US/docs/Web/API/element|Element]] )> Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Этот метод запускает ''document.querySelector'' на странице и передает его в качестве первого аргумента ''pageFunction'' . Если нет ''selector'' соответствия элемента , метод выдает ошибку.

Если ''pageFunction'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , то ''page.$eval'' будет ждать разрешения обещания и вернет его значение.

Examples:

<code javascript>
const searchValue = await page.$eval('#search', el => el.value);
const preloadHref = await page.$eval('link[rel=preload]', el => el.href);
const html = await page.$eval('.main-container', e => e.outerHTML);
</code>

Ярлык для [[#frameevalselector-pagefunction-args|page.mainFrame (). $ Eval (selector, pageFunction)]] .

==== page.$x(expression) ====

  * ''expression'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Выражение для [[https://developer.mozilla.org/en-US/docs/Web/API/Document/evaluate|оценки]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-elementhandle|ElementHandle]] >>>

Метод оценивает выражение XPath относительно документа страницы как контекстного узла.Если таких элементов нет,метод преобразуется в пустой массив.

Ярлык для [[#framexexpression|page.mainFrame (). $ X (выражение)]]

==== page.accessibility ====

  * возвращает: < [[#class-accessibility|Доступность]] >

==== page.addScriptTag(options) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > URL-адрес добавляемого скрипта.
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Путь к файлу JavaScript, который будет вставлен во фрейм. Если ''path'' является относительным путем, он разрешается относительно [[https://nodejs.org/api/process.html#process_process_cwd|текущего рабочего каталога]] .
    * ''content'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Необработанный контент JavaScript для вставки во фрейм.
    * ''type'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Тип скрипта. Используйте «модуль», чтобы загрузить модуль Javascript ES6. Смотрите [[https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script|сценарий]] для более подробной информации.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-elementhandle|ElementHandle]] >>, который разрешается в добавленный тег, когда запускается загрузка скрипта или когда содержимое скрипта было вставлено во фрейм.

Добавляет ''<script>'' на страницу с желаемым URL-адресом или содержимым.

Ярлык для [[#frameaddscripttagoptions|page.mainFrame (). AddScriptTag (параметры)]] .

==== page.addStyleTag(options) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > URL ''<link>'' .
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Путь к файлу CSS, который будет вставлен во фрейм. Если ''path'' является относительным путем, он разрешается относительно [[https://nodejs.org/api/process.html#process_process_cwd|текущего рабочего каталога]] .
    * ''content'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Необработанное содержимое CSS для вставки во фрейм.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-elementhandle|ElementHandle]] >>, который преобразуется в добавленный тег, когда срабатывает загрузка таблицы стилей или когда содержимое CSS было вставлено во фрейм.

Добавляет ''<link rel="stylesheet">'' на страницу с желаемым URL-адресом или ''<style type="text/css">'' с содержимым.

Ярлык для [[#frameaddstyletagoptions|page.mainFrame (). AddStyleTag (параметры)]] .

==== page.authenticate(credentials) ====

  * ''credentials'' <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''username'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''password'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Предоставьте учетные данные для [[https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication|аутентификации HTTP]] .

Чтобы отключить аутентификацию, передайте ''null'' .

==== page.bringToFront() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Привязка страницы к началу (активирует вкладку).

==== page.browser() ====

  * возвращает: < [[#class-browser|Браузер]] >

Получите в браузере,к которому принадлежит страница.

==== page.browserContext() ====

  * возвращает: < [[#class-browsercontext|BrowserContext]] >

Получить контекст браузера,к которому принадлежит страница.

==== страница.click(селектор[,опции]) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для поиска элемента, который нужно щелкнуть. Если есть несколько элементов, удовлетворяющих селектору, будет выбран первый.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''button'' <"left" | "right" | "middle"> По умолчанию ''left'' .
    * ''clickCount'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > по умолчанию [[https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail|равен]] 1. См. UIEvent.detail .
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Время ожидания между ''mousedown'' и ''mouseup'' в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается при успешном щелчке по ''selector'' соответствия элемента . Обещание будет отклонено, если нет ''selector'' соответствия элемента .

Этот метод выбирает элемент с помощью ''selector'' , при необходимости прокручивает его, а затем использует [[#pagemouse|page.mouse]] для щелчка в центре элемента. Если нет ''selector'' соответствия элемента , метод выдает ошибку.

Имейте в виду, что если ''click()'' запускает событие навигации и есть отдельное ''page.waitForNavigation()'' которое должно быть разрешено, вы можете получить состояние гонки, которое приведет к неожиданным результатам. Правильный шаблон для щелчка и ожидания навигации следующий:

<code javascript>
const [response] = await Promise.all([
  page.waitForNavigation(waitOptions),
  page.click(selector, clickOptions),
]);
</code>

Ярлык для [[#frameclickselector-options|page.mainFrame (). Click (селектор [, параметры])]] .

==== page.close%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''runBeforeUnload'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > По умолчанию ''false'' . Следует ли запускать обработчики страниц [[https://developer.mozilla.org/en-US/docs/Web/Events/beforeunload|перед]] выгрузкой.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

По умолчанию ''page.close()'' **не** запускается перед обработчиками выгрузки.

> **ПРИМЕЧАНИЕ,** если ''runBeforeUnload'' передается как true, может быть вызван диалог перед ''beforeunload'' который должен обрабатываться вручную через событие страницы [[#event-dialog|'dialog']] . 

==== page.content() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >>

Получает полное HTML содержимое страницы,включая тип doctype.

==== page.cookies%%([%%...urls]) ====

  * ''...urls'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >>>
    * ''name'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''value'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''domain'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''expires'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Unix-время в секундах.
    * ''size'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
    * ''httpOnly'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >
    * ''secure'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >
    * ''session'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >
    * ''sameSite'' <"Строгий" | "Слабый" | "Расширенный" | "Нет">

Если URL-адреса не указаны,этот метод возвращает куки-файлы для URL текущей страницы.Если URL-адреса указаны,возвращаются только cookie-файлы для этих URL-адресов.

==== page.coverage ====

  * возвращает: < [[#class-coverage|Покрытие]] >

==== page.deleteCookie(...cookies) ====

  * ''...cookies'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''name'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > **обязательно**
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''domain'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

==== page.emulate(options) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''viewport'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
      * ''width'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > ширина страницы в пикселях.
      * ''height'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > высота страницы в пикселях.
      * ''deviceScaleFactor'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Определяет масштабный коэффициент устройства (можно рассматривать как dpr). По умолчанию ''1'' .
      * ''isMobile'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Учитывается ли ''meta viewport'' . По умолчанию - ''false'' .
      * ''hasTouch'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, поддерживает ли область просмотра события касания. По умолчанию ''false''
      * ''isLandscape'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, находится ли область просмотра в альбомном режиме. По умолчанию - ''false'' .
    * ''userAgent'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Эмулирует заданные метрики устройства и пользовательский агент.Этот метод является ярлыком для вызова двух методов:

  * [[#pagesetuseragentuseragent|page.setUserAgent(userAgent)]]
  * [[#pagesetviewportviewport|page.setViewport(viewport)]]

Чтобы облегчить эмуляцию, кукольник предоставляет список дескрипторов устройства, который можно получить с помощью ''[[#puppeteerdevices|puppeteer.devices]]'' .

''page.emulate'' изменит размер страницы. Многие веб-сайты не ожидают, что телефоны изменят размер, поэтому вам следует выполнить эмуляцию перед переходом на страницу.

<code javascript>
const puppeteer = require('puppeteer');
const iPhone = puppeteer.devices['iPhone 6'];

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.emulate(iPhone);
  await page.goto('https://www.google.com');
  // другие действия...
  await browser.close();
})();
</code>

Список всех доступных устройств доступен в исходном коде: [[https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts|src / common / DeviceDescriptors.ts]] .

==== page.emulateIdleState(overrides) ====

  * ''overrides'' <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] > Если не задано, отменяет эмуляцию.
    * ''isUserActive'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] > **требуется**
    * ''isScreenUnlocked'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] > **требуется**
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

==== page.emulateMediaFeatures(features) ====

  * ''features'' <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Учитывая массив объектов мультимедийных функций, имитирует мультимедийные функции CSS на странице. Каждый объект мультимедийной функции должен иметь следующие свойства:
    * ''name'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Имя медиа-функции CSS. Поддерживаемые имена: '''prefers-colors-scheme''' , '''prefers-reduced-motion''' и '''color-gamut''' .
    * ''value'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Значение для данной медиа-функции CSS.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

<code javascript>
await page.emulateMediaFeatures([{ name: 'prefers-color-scheme', value: 'dark' }]);
await page.evaluate(() => matchMedia('(prefers-color-scheme: dark)').matches);
// → true
await page.evaluate(() => matchMedia('(prefers-color-scheme: light)').matches);
// → false

await page.emulateMediaFeatures([{ name: 'prefers-reduced-motion', value: 'reduce' }]);
await page.evaluate(() => matchMedia('(prefers-reduced-motion: reduce)').matches);
// → true
await page.evaluate(() => matchMedia('(prefers-reduced-motion: no-preference)').matches);
// → false

await page.emulateMediaFeatures([
  { name: 'prefers-color-scheme', value: 'dark' },
  { name: 'prefers-reduced-motion', value: 'reduce' },
]);
await page.evaluate(() => matchMedia('(prefers-color-scheme: dark)').matches);
// → true
await page.evaluate(() => matchMedia('(prefers-color-scheme: light)').matches);
// → false
await page.evaluate(() => matchMedia('(prefers-reduced-motion: reduce)').matches);
// → true
await page.evaluate(() => matchMedia('(prefers-reduced-motion: no-preference)').matches);
// → false

await page.emulateMediaFeatures([
  { name: 'color-gamut', value: 'p3' },
]);
await page.evaluate(() => matchMedia('(color-gamut: srgb)').matches);
// → true
await page.evaluate(() => matchMedia('(color-gamut: p3)').matches);
// → true
await page.evaluate(() => matchMedia('(color-gamut: rec2020)').matches);
// → false
</code>

==== page.emulateMediaType(type) ====

  * ''type'' <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Изменяет медиа-тип CSS страницы. Единственные допустимые значения - '''screen''' , '''print''' и ''null'' . Передача ''null'' отключает эмуляцию мультимедиа CSS.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

<code javascript>
await page.evaluate(() => matchMedia('screen').matches);
// → true
await page.evaluate(() => matchMedia('print').matches);
// → false

await page.emulateMediaType('print');
await page.evaluate(() => matchMedia('screen').matches);
// → false
await page.evaluate(() => matchMedia('print').matches);
// → true

await page.emulateMediaType(null);
await page.evaluate(() => matchMedia('screen').matches);
// → true
await page.evaluate(() => matchMedia('print').matches);
// → false
</code>

==== page.emulateNetworkConditions(networkConditions) ====

  * ''networkConditions'' <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] > Передача ''null'' отключает эмуляцию состояния сети.
    * ''download'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Скорость загрузки (байт / с), ''-1'' для отключения
    * ''upload'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Скорость загрузки (байт / с), ''-1'' для отключения
    * ''latency'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Задержка (мс), ''0'' для отключения
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

> **ПРИМЕЧАНИЕ.** Это не влияет на WebSockets и WebRTC PeerConnections (см. [[https://crbug.com/563644|Https://crbug.com/563644]] ). 

<code javascript>
const puppeteer = require('puppeteer');
const slow3G = puppeteer.networkConditions['Slow 3G'];

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.emulateNetworkConditions(slow3G);
  await page.goto('https://www.google.com');
  // другие действия...
  await browser.close();
})();
</code>

==== page.emulateTimezone(timezoneId) ====

  * ''timezoneId'' <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Изменяет часовой пояс страницы. Список поддерживаемых идентификаторов часовых ''[[https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1|metaZones.txt]]'' см. В файле metaZones.txt ICU . Передача ''null'' отключает эмуляцию часового пояса.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

==== page.emulateVisionDeficiency(type) ====

  * ''type'' <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Имитирует данный недостаток зрения на странице. Поддерживаемые типы дефицита зрения: '''achromatopsia''' , '''deuteranopia''' , '''protanopia''' , '''tritanopia''' , '''blurredVision''' и '''none''' .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://v8.dev/blog/10-years');

  await page.emulateVisionDeficiency('achromatopsia');
  await page.screenshot({ path: 'achromatopsia.png' });

  await page.emulateVisionDeficiency('deuteranopia');
  await page.screenshot({ path: 'deuteranopia.png' });

  await page.emulateVisionDeficiency('blurredVision');
  await page.screenshot({ path: 'blurred-vision.png' });

  await browser.close();
})();
</code>

==== page.assess(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция, которая будет оцениваться в контексте страницы
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Если функция, переданная ''page.evaluate'' , возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|обещание]] , то ''page.evaluate'' будет ждать разрешения обещания и вернет свое значение.

Если функция передается ''page.evaluate'' возвращает значение не [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] значения, то ''page.evaluate'' ПОСТАНОВЛЯЕТ ''undefined'' . Протокол DevTools также поддерживает передачу некоторых дополнительных значений, не сериализуемых с помощью ''JSON'' : ''-0'' , ''NaN'' , ''Infinity'' , ''-Infinity'' и литералы bigint.

Передача аргументов в ''pageFunction'' :

<code javascript>
const result = await page.evaluate(x => {
  return Promise.resolve(8 * x);
}, 7);
console.log(result); // выводит "56"
</code>

Также вместо функции может быть передана строка:

<code javascript>
console.log(await page.evaluate('1 + 2')); // выводит "3"
const x = 10;
console.log(await page.evaluate(`1 + ${x}`)); // выводит "11"
</code>

Экземпляры ElementHandle могут быть переданы в качестве аргументов ''page.evaluate'' :

<code javascript>
const bodyHandle = await page.$('body');
const html = await page.evaluate(body => body.innerHTML, bodyHandle);
await bodyHandle.dispose();
</code>

Ярлык для [[#frameevaluatepagefunction-args|page.mainFrame (). Оценить (pageFunction, ... args)]] .

==== page.assessHandle(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция, которая будет оцениваться в контексте страницы
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] | [[#class-elementhandle|ElementHandle]] >> Promise, которое ''pageFunction'' в возвращаемое значение pageFunction как внутристраничный объект.

Единственная разница между ''page.evaluate'' и ''page.evaluateHandle'' заключается в том, что ''page.evaluateHandle'' возвращает объект на странице (JSHandle).

Если функция, переданная в ''page.evaluateHandle'' , возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , то ''page.evaluateHandle'' будет ждать, пока обещание разрешится, и вернет свое значение.

Также вместо функции может быть передана строка:

<code javascript>
const aHandle = await page.evaluateHandle('document'); // Дескриптор документа
</code>

[[#class-jshandle|Экземпляры JSHandle]] могут быть переданы в качестве аргументов ''page.evaluateHandle'' :

<code javascript>
const aHandle = await page.evaluateHandle(() => document.body);
const resultHandle = await page.evaluateHandle(body => body.innerHTML, aHandle);
console.log(await resultHandle.jsonValue());
await resultHandle.dispose();
</code>

Эта функция по умолчанию возвращает [[#class-jshandle|JSHandle]] , однако, если ваша ''pageFunction'' возвращает HTML-элемент, вы получите ''ElementHandle'' :

<code javascript>
const button = await page.evaluateHandle(() => document.querySelector('button'))
// кнопка - это ElementHandle, поэтому вы можете вызывать такие методы, как click:
await button.click();
</code>

Ярлык для [[#executioncontextevaluatehandlepagefunction-args|page.mainFrame (). ExecuteContext (). AssessmentHandle (pageFunction, ... args)]] .

==== page.оценитьOnNewDocument(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] > Аргументы для передачи в ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Добавляет функцию,которая будет вызвана в одном из следующих сценариев:

  * во время навигации по странице
  * всякий раз,когда крепится или перемещается детская рама.В этом случае функция вызывается в контексте вновь прикрепленного кадра

Функция вызывается после создания документа, но до запуска любого из его сценариев. Это полезно для внесения изменений в среду JavaScript, например, для ''Math.random'' .

Пример переопределения свойства navigator.languages перед загрузкой страницы:

<code javascript>
// preload.js

// перезаписываем свойство `languages` для использования специального получателя
Object.defineProperty(navigator, "languages", {
  get: function() {
    return ["en-US", "en", "bn"];
  }
});

// В вашем скрипте кукловода предполагается, что файл preload.js находится в той же папке, что и наш скрипт
const preloadFile = fs.readFileSync('./preload.js', 'utf8');
await page.evaluateOnNewDocument(preloadFile);
</code>

==== page.exposeFunction(имя,куклаFunction) ====

  * ''name'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Имя функции в объекте окна
  * ''puppeteerFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] > Функция обратного вызова, которая будет вызываться в контексте Puppeteer.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Метод добавляет функцию с именем ''name'' в объект ''window'' страницы . При вызове функция выполняет ''puppeteerFunction'' в node.js и возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise,]] которое преобразуется в возвращаемое значение ''puppeteerFunction'' .

Если ''puppeteerFunction'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|обещание]] , оно будет ожидаться.

> **ПРИМЕЧАНИЕ** Функции, установленные через ''page.exposeFunction'' , остаются в силе при навигации. 

Пример добавления функции ''md5'' на страницу:

<code javascript>
const puppeteer = require('puppeteer');
const crypto = require('crypto');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  page.on('console', msg => console.log(msg.text()));
  await page.exposeFunction('md5', text =>
    crypto.createHash('md5').update(text).digest('hex')
  );
  await page.evaluate(async () => {
    // используем window.md5 для вычисления хэшей
    const myString = 'PUPPETEER';
    const myHash = await window.md5(myString);
    console.log(`md5 of ${myString} is ${myHash}`);
  });
  await browser.close();
})();
</code>

Пример добавления на ''window.readfile'' функции window.readfile :

<code javascript>
const puppeteer = require('puppeteer');
const fs = require('fs');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  page.on('console', msg => console.log(msg.text()));
  await page.exposeFunction('readfile', async filePath => {
    return new Promise((resolve, reject) => {
      fs.readFile(filePath, 'utf8', (err, text) => {
        if (err)
          reject(err);
        else
          resolve(text);
      });
    });
  });
  await page.evaluate(async () => {
    // используем window.readfile для чтения содержимого файла
    const content = await window.readfile('/etc/hosts');
    console.log(content);
  });
  await browser.close();
})();
</code>

==== page.focus(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] элемента, на который нужно сфокусироваться. Если есть несколько элементов, удовлетворяющих селектору, первый будет сфокусирован.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается, когда ''selector'' сопоставления элементов успешно сфокусирован. Обещание будет отклонено, если нет ''selector'' соответствия элементов .

Этот метод выбирает элемент с помощью ''selector'' и фокусирует его. Если нет ''selector'' соответствия элемента , метод выдает ошибку.

Ярлык для [[#framefocusselector|page.mainFrame (). Focus (селектор)]] .

==== page.frames() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-frame|Frame]] >> Массив всех фреймов, прикрепленных к странице.

==== page.goBack%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Параметры навигации, которые могут иметь следующие свойства:
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время навигации в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaultnavigationtimeouttimeout|методов page.setDefaultNavigationTimeout (тайм-аут)]] или [[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout (тайм-аут)]] .
    * ''waitUntil'' <"load" | "domcontentloaded" | "networkidle0" | "networkidle2" | Array> Если считать, что навигация прошла успешно, по умолчанию используется ''load'' . Учитывая массив строк событий, навигация считается успешной после того, как все события были запущены. События могут быть:
      * ''load'' - считайте, что навигация завершена, когда запускается событие ''load'' .
      * ''domcontentloaded'' - считается, что навигация завершена, когда ''DOMContentLoaded'' событие DOMContentLoaded .
      * ''networkidle0'' - считать, что навигация завершена, если не более 0 сетевых подключений в течение не менее ''500'' мс.
      * ''networkidle2'' - считайте, что навигация завершена, если не более 2 сетевых подключений в течение не менее ''500'' мс.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-httpresponse|HTTPResponse]] >> Promise, которое разрешается в ответ основного ресурса. В случае нескольких перенаправлений навигация разрешится с ответом последнего перенаправления. Если не может вернуться, принимает значение ''null'' .

Перейдите на предыдущую страницу в истории.

==== page.goForward%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Параметры навигации, которые могут иметь следующие свойства:
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время навигации в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaultnavigationtimeouttimeout|методов page.setDefaultNavigationTimeout (тайм-аут)]] или [[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout (тайм-аут)]] .
    * ''waitUntil'' <"load" | "domcontentloaded" | "networkidle0" | "networkidle2" | Array> Если считать, что навигация прошла успешно, по умолчанию используется ''load'' . Учитывая массив строк событий, навигация считается успешной после того, как все события были запущены. События могут быть:
      * ''load'' - считайте, что навигация завершена, когда запускается событие ''load'' .
      * ''domcontentloaded'' - считается, что навигация завершена, когда ''DOMContentLoaded'' событие DOMContentLoaded .
      * ''networkidle0'' - считать, что навигация завершена, если не более 0 сетевых подключений в течение не менее ''500'' мс.
      * ''networkidle2'' - считайте, что навигация завершена, если не более 2 сетевых подключений в течение не менее ''500'' мс.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-httpresponse|HTTPResponse]] >> Promise, которое разрешается в ответ основного ресурса. В случае нескольких перенаправлений навигация разрешится с ответом последнего перенаправления. Если не может продолжить, принимает значение ''null'' .

Перейдите на следующую страницу истории.

==== page.goto(url[,опции]) ====

  * ''url'' %%<%% [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] %%>%% URL для перехода на страницу. URL-адрес должен включать схему, например %%''https://''%% .
  * ''options'' %%<%% [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] %%>%% Параметры навигации, которые могут иметь следующие свойства:
     * ''timeout'' %%<%% [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] %%>%% Максимальное время навигации в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaultnavigationtimeouttimeout|методов page.setDefaultNavigationTimeout (тайм-аут)]] или [[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout (тайм-аут)]] .
     * ''waitUntil'' %%<%%"load" | "domcontentloaded" | "networkidle0" | "networkidle2" | Array%%>%% Если считать, что навигация прошла успешно, по умолчанию используется ''load'' . Учитывая массив строк событий, навигация считается успешной после того, как все события были запущены. События могут быть:
       * ''load'' - считайте, что навигация завершена, когда запускается событие ''load'' .
       * ''domcontentloaded'' - считается, что навигация завершена, когда ''DOMContentLoaded'' событие DOMContentLoaded .
       * ''networkidle0'' - считать, что навигация завершена, если не более 0 сетевых подключений в течение не менее ''500'' мс.
       * ''networkidle2'' - считайте, что навигация завершена, если не более 2 сетевых подключений в течение не менее ''500'' мс.
    * ''referer'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Значение заголовка Referer. Если он предоставлен, он будет иметь приоритет над значением заголовка [[#pagesetextrahttpheadersheaders|реферера,]] установленным page.setExtraHTTPHeaders () .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-httpresponse|HTTPResponse]] >> Promise, которое разрешается в ответ основного ресурса. В случае нескольких перенаправлений навигация разрешится с ответом последнего перенаправления.

''page.goto'' выдаст ошибку, если:

  * есть ошибка SSL (например,в случае самоподписанных сертификатов).
  * целевой URL-адрес недействителен.
  * время ''timeout'' превышено во время навигации.
  * удаленный сервер не отвечает или недоступен.
  * основной ресурс не загрузился.

''page.goto'' не выдаст ошибку, если удаленный сервер вернет любой допустимый код состояния HTTP, включая 404 «Не найдено» и 500 «Внутренняя ошибка сервера». Код состояния для таких ответов можно получить, вызвав [[#httpresponsestatus|response.status ()]] .

> **ПРИМЕЧАНИЕ** ''page.goto'' либо выдает ошибку, либо возвращает ответ основного ресурса. Единственными исключениями являются переход к ''about:blank'' или переход к тому же URL-адресу с другим хешем, который завершится успешно и вернет ''null'' . 

> **ПРИМЕЧАНИЕ.** Режим «Без заголовка» не поддерживает переход к документу PDF. См. Проблему с [[https://bugs.chromium.org/p/chromium/issues/detail?id=761295|восходящим потоком]] . 

Ярлык для [[#framegotourl-options|page.mainFrame (). Goto (URL, параметры)]]

==== page.hover(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для поиска элемента для наведения. Если есть несколько элементов, удовлетворяющих селектору, первый будет зависать.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается, когда ''selector'' соответствия элемента успешно зависает. Обещание отклоняется, если нет ''selector'' соответствия элементов .

Этот метод выбирает элемент с помощью ''selector'' , при необходимости прокручивает его, а затем использует [[#pagemouse|page.mouse]] для наведения курсора на центр элемента. Если нет ''selector'' соответствия элемента , метод выдает ошибку.

Ярлык для [[#framehoverselector|page.mainFrame (). Hover (селектор)]] .

==== page.isClosed() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >

Показывает,что страница закрыта.

==== page.isJavaScriptEnabled() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >

Возвращает ''true'' , если на странице включен JavaScript, иначе ''false'' .

==== page.keyboard ====

  * возвращает: < [[#class-keyboard|Keyboard]] >

==== page.mainFrame() ====

  * возвращает: < [[#class-frame|Frame]] > Главный фрейм страницы.

Страница гарантированно имеет основную рамку,которая сохраняется во время навигации.

==== page.metrics() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Объект, содержащий метрики в виде пар ключ / значение.
    * ''Timestamp'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Отметка времени, когда была взята выборка показателей.
    * ''Documents'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|количество]] > Количество документов на странице.
    * ''Frames'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Количество кадров на странице.
    * ''JSEventListeners'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Количество событий на странице.
    * ''Nodes'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Число узлов DOM на странице.
    * ''LayoutCount'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Общее количество полных или частичных макетов страницы.
    * ''RecalcStyleCount'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Общее количество перерасчетов стилей страницы.
    * ''LayoutDuration'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Общая продолжительность всех макетов страницы.
    * ''RecalcStyleDuration'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Общая длительность всех пересчетов стилей страницы.
    * ''ScriptDuration'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Общая продолжительность выполнения JavaScript.
    * ''TaskDuration'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Суммарная продолжительность всех задач, выполняемых браузером.
    * ''JSHeapUsedSize'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Используемый размер кучи JavaScript.
    * ''JSHeapTotalSize'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Общий размер кучи JavaScript.

> **ПРИМЕЧАНИЕ** Все временные метки имеют монотонное время: монотонно увеличивающееся время в секундах с произвольной точки в прошлом. 

==== page.mouse ====

  * возвращает: < [[#class-mouse|Мышь]] >

==== page.pdf%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Объект параметров, который может иметь следующие свойства:
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Путь к файлу для сохранения PDF-файла. Если ''path'' является относительным путем, он разрешается относительно [[https://nodejs.org/api/process.html#process_process_cwd|текущего рабочего каталога]] . Если путь не указан, PDF-файл не будет сохранен на диск.
    * ''scale'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Масштаб отрисовки веб-страницы. По умолчанию ''1'' . Значение шкалы должно быть от 0,1 до 2.
    * ''displayHeaderFooter'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Отображать верхний и нижний колонтитулы. По умолчанию - ''false'' .
    * ''headerTemplate'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > HTML-шаблон для заголовка печати. Должна быть допустимая разметка HTML со следующими классами, используемыми для вставки в них значений печати:
      * ''date'' печати дата
      * ''title'' документа
      * ''url'' документа
      * ''pageNumber'' номер текущей страницы
      * ''totalPages'' общее количество страниц в документе
    * ''footerTemplate'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > HTML-шаблон для нижнего колонтитула печати. Следует использовать тот же формат, что и ''headerTemplate'' .
    * ''printBackground'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Печать фоновой графики. По умолчанию - ''false'' .
    * ''landscape'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическая]] > Ориентация бумаги. По умолчанию - ''false'' .
    * ''pageRanges'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Диапазон бумаги для печати, например, «1-5, 8, 11-13». По умолчанию используется пустая строка, что означает печать всех страниц.
    * ''format'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Формат бумаги. Если установлено, имеет приоритет над параметрами ''width'' или ''height'' . По умолчанию "Письмо".
    * ''width'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Ширина бумаги, принимает значения, обозначенные единицами измерения.
    * ''height'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Высота бумаги, принимает значения, помеченные единицами измерения.
    * ''margin'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Поля бумаги, по умолчанию нет.
      * ''top'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Верхнее поле, принимает значения, помеченные единицами измерения.
      * ''right'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Правое поле, принимает значения, помеченные единицами измерения.
      * ''bottom'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Нижнее поле, принимает значения, помеченные единицами измерения.
      * ''left'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Левое поле, принимает значения, помеченные единицами измерения.
    * ''preferCSSPageSize'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Присвойте любому размеру CSS ''@page'' , объявленному в приоритете страницы, над тем, что объявлено в параметрах ''width'' и ''height'' или ''format'' . По умолчанию установлено значение ''false'' , при котором содержимое масштабируется в соответствии с размером бумаги.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://nodejs.org/api/buffer.html#buffer_class_buffer|Buffer]] >> Promise, которое разрешается с помощью буфера PDF.

> **ПРИМЕЧАНИЕ. В** настоящее время создание PDF-файлов поддерживается только в Chrome Headless. 

''page.pdf()'' генерирует PDF-файл страницы с ''print'' носителем css. Чтобы создать PDF-файл с ''screen'' носителем, вызовите [[#pageemulatemediatypetype|page.emulateMediaType ('screen')]] перед вызовом ''page.pdf()'' :

> **ПРИМЕЧАНИЕ** По умолчанию ''page.pdf()'' создает PDF-файл с измененными цветами для печати. Используйте ''[[https://developer.mozilla.org/en-US/docs/Web/CSS/-webkit-print-color-adjust|-webkit-print-color-adjust]]'' для принудительной визуализации точных цветов. 

<code javascript>
// Generates a PDF with 'screen' media type.
await page.emulateMediaType('screen');
await page.pdf({path: 'page.pdf'});
</code>

Параметры ''width'' , ''height'' и ''margin'' принимают значения, помеченные единицами измерения. Значения без меток обрабатываются как пиксели.

Несколько примеров:

  * ''page.pdf%%({%%width: 100})'' - печатает с шириной 100 пикселей.
  * ''page.pdf%%({%%width: '100px'})'' - печатает с шириной 100 пикселей
  * ''page.pdf%%({%%width: '10cm'})'' - печать шириной 10 сантиметров.

Все возможные единицы:

  * ''px'' - пиксель
  * ''in'' - дюйм
  * ''cm'' - сантиметр
  * ''mm'' - миллиметр

В ''format'' опции:

  * ''Letter'' : 8,5 x 11 дюймов
  * ''Legal'' : 8,5 x 14 дюймов
  * ''Tabloid'' : 11 дюймов x 17 дюймов
  * ''Ledger'' : 17in х 11in
  * ''A0'' : 33,1 x 46,8 дюйма
  * ''A1'' : 23,4 дюйма x 33,1 дюйма
  * ''A2'' : 16,54 x 23,4 дюйма
  * ''A3'' : 11,7 x 16,54 дюйма
  * ''A4'' : 8,27 x 11,7 дюйма
  * ''A5'' : 5,83 x 8,27 дюйма
  * ''A6'' : 4,13 дюйма x 5,83 дюйма

> **ПРИМЕЧАНИЕ.** ''headerTemplate'' и ''footerTemplate'' имеет следующие ограничения: Теги сценариев внутри шаблонов не оцениваются. Стили страниц не видны внутри шаблонов. 

==== page.queryObjects(prototypeHandle) ====

  * ''prototypeHandle'' < [[#class-jshandle|JSHandle]] > Дескриптор прототипа объекта.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] >> Promise, которое преобразуется в дескриптор массива объектов с этим прототипом.

Метод итерирует кучу JavaScript и находит все объекты с данным прототипом.

<code javascript>
// Создаем объект Map
await page.evaluate(() => window.map = new Map());
// Получаем дескриптор прототипа объекта Map
const mapPrototype = await page.evaluateHandle(() => Map.prototype);
// Запрос всех экземпляров карты в массив
const mapInstances = await page.queryObjects(mapPrototype);
// Подсчитываем количество объектов карты в куче
const count = await page.evaluate(maps => maps.length, mapInstances);
await mapInstances.dispose();
await mapPrototype.dispose();
</code>

Ярлык для [[#executioncontextqueryobjectsprototypehandle|page.mainFrame (). ExecuteContext (). QueryObjects (prototypeHandle)]] .

==== page.reload%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Параметры навигации, которые могут иметь следующие свойства:
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время навигации в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaultnavigationtimeouttimeout|методов page.setDefaultNavigationTimeout (тайм-аут)]] или [[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout (тайм-аут)]] .
    * ''waitUntil'' <"load" | "domcontentloaded" | "networkidle0" | "networkidle2" | Array> Если считать, что навигация прошла успешно, по умолчанию используется ''load'' . Учитывая массив строк событий, навигация считается успешной после того, как все события были запущены. События могут быть:
      * ''load'' - считайте, что навигация завершена, когда запускается событие ''load'' .
      * ''domcontentloaded'' - считается, что навигация завершена, когда ''DOMContentLoaded'' событие DOMContentLoaded .
      * ''networkidle0'' - считать, что навигация завершена, если не более 0 сетевых подключений в течение не менее ''500'' мс.
      * ''networkidle2'' - считайте, что навигация завершена, если не более 2 сетевых подключений в течение не менее ''500'' мс.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-httpresponse|HTTPResponse]] >> Promise, которое разрешается в ответ основного ресурса. В случае нескольких перенаправлений навигация разрешится с ответом последнего перенаправления.

==== page.screenshot%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Объект параметров, который может иметь следующие свойства:
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Путь к файлу для сохранения изображения. Тип скриншота определяется расширением файла. Если ''path'' является относительным путем, он разрешается относительно [[https://nodejs.org/api/process.html#process_process_cwd|текущего рабочего каталога]] . Если путь не указан, изображение не будет сохранено на диск.
    * ''type'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Укажите тип скриншота, может быть ''jpeg'' или ''png'' . По умолчанию - png.
    * ''quality'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Качество изображения от 0 до 100. Не применимо к изображениям ''png'' .
    * ''fullPage'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Если установлено значение true, делает снимок экрана с полной прокручиваемой страницей. По умолчанию - ''false'' .
    * ''clip'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Объект, определяющий область обрезки страницы. Должны быть следующие поля:
      * ''x'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > x-координата верхнего левого угла области клипа
      * ''y'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > y-координата левого верхнего угла области клипа
      * ''width'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > ширина области обрезки
      * ''height'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > высота области отсечения
    * ''omitBackground'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Скрывает белый фон по умолчанию и позволяет делать снимки экрана с прозрачностью. По умолчанию - ''false'' .
    * ''encoding'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Кодировка изображения может быть ''base64'' или ''binary'' . По умолчанию ''binary'' .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] | [[https://nodejs.org/api/buffer.html#buffer_class_buffer|Buffer]] >> Promise, который разрешается в буфер или строку base64 (в зависимости от значения ''encoding'' ) с захваченным снимком экрана.

> **ПРИМЕЧАНИЕ.** Снимки экрана в OS X занимают не менее 1/6 секунды. См. Обсуждение на [[https://crbug.com/741689|https://crbug.com/741689]] . 

==== страница.выбор(селектор,...значения) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса страницы для
  * ''...values'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Значения параметров для выбора. Если ''<select>'' имеет атрибут ''multiple'' , учитываются все значения, в противном случае учитывается только первое.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >>> Массив значений параметров, которые были успешно выбраны.

Запускает событие ''change'' и ''input'' после выбора всех предоставленных параметров. Если нет ''selector'' соответствия элемента ''<select>'' , метод выдает ошибку.

<code javascript>
page.select('select#colors', 'blue'); // одиночный выбор
page.select('select#colors', 'red', 'green', 'blue'); // множественный выбор
</code>

Ярлык для [[#frameselectselector-values|page.mainFrame (). Select ()]]

==== page.setBypassCSP(enabled) ====

  * ''enabled'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > устанавливает обход Content-Security-Policy страницы.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Переключатели,минуя Контент-Политика Безопасности-Содержание страницы.

> **ПРИМЕЧАНИЕ.** Обход CSP происходит в момент инициализации CSP, а не при оценке. Обычно это означает, что ''page.setBypassCSP'' следует вызывать перед переходом в домен. 

==== page.setCacheEnabled%%([%%enabled]) ====

  * ''enabled'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > устанавливает ''enabled'' состояние кеша.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Переключает игнорирование кэша для каждого запроса в зависимости от включенного состояния.По умолчанию кэширование включено.

==== page.setContent(html[,options])) ====

  * ''html'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > HTML-разметка для назначения странице.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Параметры, которые могут иметь следующие свойства:
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время в миллисекундах для загрузки ресурсов, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaultnavigationtimeouttimeout|методов page.setDefaultNavigationTimeout (тайм-аут)]] или [[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout (тайм-аут)]] .
    * ''waitUntil'' <"load" | "domcontentloaded" | "networkidle0" | "networkidle2" | Array> Когда считать, что установка разметки прошла успешно, по умолчанию используется ''load'' . Учитывая массив строк событий, настройка содержимого считается успешной после того, как все события были запущены. События могут быть:
      * ''load'' - рассмотрите возможность завершения настройки содержимого при срабатывании события ''load'' .
      * ''domcontentloaded'' - рассмотрите возможность завершения настройки содержимого при ''DOMContentLoaded'' события DOMContentLoaded .
      * ''networkidle0'' - считайте, что настройка содержимого завершена, если не более 0 сетевых подключений в течение не менее ''500'' мс.
      * ''networkidle2'' - считайте, что настройка содержимого завершена, если не более 2 сетевых подключений в течение не менее ''500'' мс.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

==== page.setCookie(...cookies) ====

  * ''...cookies'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''name'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > **обязательно**
    * ''value'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > **требуется**
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''domain'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >
    * ''expires'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Unix-время в секундах.
    * ''httpOnly'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >
    * ''secure'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >
    * ''sameSite'' <"Строгий" | "Слабый">
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

<code javascript>
await page.setCookie(cookieObject1, cookieObject2);
</code>

==== page.setDefaultNavigationTimeout(timeout) ====

  * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время навигации в миллисекундах

Эта настройка изменит максимальное время навигации по умолчанию для следующих методов и связанных с ними ярлыков:

  * [[#pagegobackoptions|page.goBack([options])]]
  * [[#pagegoforwardoptions|page.goForward([options])]]
  * [[#pagegotourl-options|page.goto(url[,опции])]]
  * [[#pagereloadoptions|page.reload([options])]]
  * [[#pagesetcontenthtml-options|page.setContent(html[,options]))]]
  * [[#pagewaitfornavigationoptions|page.waitForNavigation([options])]]

> **ПРИМЕЧАНИЕ** ''[[#pagesetdefaultnavigationtimeouttimeout|page.setDefaultNavigationTimeout]]'' имеет приоритет над ''[[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout]]'' 

==== page.setDefaultTimeout(timeout) ====

  * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время в миллисекундах

Эта настройка изменит максимальное время по умолчанию для следующих методов и связанных с ними ярлыков:

  * [[#pagegobackoptions|page.goBack([options])]]
  * [[#pagegoforwardoptions|page.goForward([options])]]
  * [[#pagegotourl-options|page.goto(url[,опции])]]
  * [[#pagereloadoptions|page.reload([options])]]
  * [[#pagesetcontenthtml-options|page.setContent(html[,options]))]]
  * [[#pagewaitforselectororfunctionortimeout-options-args|page.waitFor(selectorOrFunctionOrTimeout[,options[,...args]])).]]
  * [[#pagewaitforfilechooseroptions|page.waitForFileChooser([options])]]
  * [[#pagewaitforfunctionpagefunction-options-args|page.waitForFunction(pageFunction[,options[,...args]])).]]
  * [[#pagewaitfornavigationoptions|page.waitForNavigation([options])]]
  * [[#pagewaitforrequesturlorpredicate-options|page.waitForRequest(urlOrPredicate[,опции]))]]
  * [[#pagewaitforresponseurlorpredicate-options|page.waitForResponse(urlOrPredicate[,опции]))]]
  * [[#pagewaitforselectorselector-options|page.waitForSelector(selector[,options]))]]
  * [[#pagewaitforxpathxpath-options|page.waitForXPath(xpath[,опции]))]]

> **ПРИМЕЧАНИЕ** ''[[#pagesetdefaultnavigationtimeouttimeout|page.setDefaultNavigationTimeout]]'' имеет приоритет над ''[[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout]]'' 

==== page.setExtraHTTPHeaders(headers) ====

  * ''headers'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Объект, содержащий дополнительные заголовки HTTP, отправляемые с каждым запросом. Все значения заголовка должны быть строками.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Дополнительные HTTP-заголовки будут отправляться с каждым запросом,который инициирует страница.

> **ПРИМЕЧАНИЕ** page.setExtraHTTPHeaders не гарантирует порядок заголовков в исходящих запросах. 

==== page.setGeolocation(options) ====

  * ''options'' <[[#geolocationoptions|GeolocationOptions]]>
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Устанавливает геолокацию страницы.

<code javascript>
await page.setGeolocation({latitude: 59.95, longitude: 30.31667});
</code>

> **ПРИМЕЧАНИЕ.** Рассмотрите возможность использования [[#browsercontextoverridepermissionsorigin-permissions|browserContext.overridePermissions,]] чтобы предоставить странице разрешения на чтение ее геолокации. 

==== page.setJavaScriptEnabled(enabled) ====

  * ''enabled'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Включать или нет JavaScript на странице.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

> **ПРИМЕЧАНИЕ.** Изменение этого значения не повлияет на уже запущенные сценарии. Он вступит в силу при следующей [[#pagegotourl-options|навигации]] . 

==== page.setOfflineMode(enabled) ====

  * ''enabled'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Когда ''true'' , включает автономный режим для страницы.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

==== page.setRequestInterception(value) ====

  * ''value'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Разрешить ли перехват запросов.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Активация перехвата запросов включает методы ''request.abort'' , ''request.continue'' и ''request.respond'' . Это дает возможность изменять сетевые запросы, которые делает страница.

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

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.setRequestInterception(true);
  page.on('request', interceptedRequest => {
    if (interceptedRequest.url().endsWith('.png') || interceptedRequest.url().endsWith('.jpg'))
      interceptedRequest.abort();
    else
      interceptedRequest.continue();
  });
  await page.goto('https://example.com');
  await browser.close();
})();
</code>

> **ПРИМЕЧАНИЕ** Включение перехвата запросов отключает кеширование страниц. 

==== page.setUserAgent(userAgent) ====

  * ''userAgent'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Определенный пользовательский агент для использования на этой странице
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается при установке пользовательского агента.

==== page.setViewport(viewport) ====

  * ''viewport'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''width'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > ширина страницы в пикселях. **обязательный**
    * ''height'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > высота страницы в пикселях. **обязательный**
    * ''deviceScaleFactor'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Определяет масштабный коэффициент устройства (можно рассматривать как dpr). По умолчанию ''1'' .
    * ''isMobile'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Учитывается ли ''meta viewport'' . По умолчанию - ''false'' .
    * ''hasTouch'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, поддерживает ли область просмотра события касания. По умолчанию ''false''
    * ''isLandscape'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, находится ли область просмотра в альбомном режиме. По умолчанию - ''false'' .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

> **ПРИМЕЧАНИЕ:** в некоторых случаях при настройке области просмотра страница перезагружается для установки свойств ''isMobile'' или ''hasTouch'' . 

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

''page.setViewport'' изменит размер страницы. Многие веб-сайты не ожидают, что телефоны изменят размер, поэтому вам следует установить область просмотра перед переходом на страницу.

<code javascript>
const page = await browser.newPage();
await page.setViewport({
  width: 640,
  height: 480,
  deviceScaleFactor: 1,
});
await page.goto('https://example.com');
</code>

==== page.tap(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для поиска элемента, который нужно нажать. Если есть несколько элементов, удовлетворяющих селектору, будет выбран первый.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Этот метод выбирает элемент с помощью ''selector'' , при необходимости прокручивает его, а затем использует [[#pagetouchscreen|page.touchscreen]] для нажатия в центре элемента. Если нет ''selector'' соответствия элемента , метод выдает ошибку.

Ярлык для [[#frametapselector|page.mainFrame (). Tap (селектор)]] .

==== page.target() ====

  * возвращает: < [[#class-target|Target]] > цель, из которой была создана эта страница.

==== page.title() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Заголовок страницы.

Ярлык для [[#frametitle|page.mainFrame (). Title ()]] .

==== page.touchscreen ====

  * возвращает: < [[#class-touchscreen|Touchscreen]] >

==== page.tracing ====

  * возвращает: < [[#class-tracing|Трассировка]] >

==== page.type(селектор,text[,опции])) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] элемента для ввода. Если есть несколько элементов, удовлетворяющих селектору, будет использован первый.
  * ''text'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Текст для ввода в выбранный элемент.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Время ожидания между нажатиями клавиш в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Посылает ''keydown'' , ''keypress'' / ''input'' и ''keyup'' событие для каждого символа в тексте.

Чтобы нажать специальную клавишу, например ''Control'' или ''ArrowDown'' , используйте ''[[#keyboardpresskey-options|keyboard.press]]'' .

<code javascript>
await page.type('#mytextarea', 'Hello'); // Мгновенно набирает
await page.type('#mytextarea', 'World', {delay: 100}); // Набирает медленнее, как пользователь
</code>

Ярлык для [[#frametypeselector-text-options|page.mainFrame (). Type (селектор, текст [, параметры])]] .

==== page.url() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

Это ярлык для [[#frameurl|page.mainFrame (). Url ()]]

==== page.viewport() ====

  * возвращает: <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''width'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > ширина страницы в пикселях.
    * ''height'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > высота страницы в пикселях.
    * ''deviceScaleFactor'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Укажите масштабный коэффициент устройства (может быть как dpr). По умолчанию ''1'' .
    * ''isMobile'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Учитывается ли ''meta viewport'' . По умолчанию - ''false'' .
    * ''hasTouch'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, поддерживает ли область просмотра события касания. По умолчанию ''false''
    * ''isLandscape'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, находится ли область просмотра в альбомном режиме. По умолчанию - ''false'' .

==== page.waitFor(selectorOrFunctionOrTimeout[,options[,...args]])). ====

  * ''selectorOrFunctionOrTimeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|номер]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] , предикат или тайм-аут для ожидания
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
    * ''visible'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > дождитесь, пока элемент появится в DOM и станет видимым. По умолчанию - ''false'' .
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > максимальное время ожидания в миллисекундах. По умолчанию ''30000'' (30 секунд). Передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .
    * ''hidden'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > ждать, пока элемент не будет найден в DOM или будет скрыт. По умолчанию - ''false'' .
    * ''polling'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Интервал, с которым выполняется ''pageFunction'' , по умолчанию ''raf'' . Если ''polling'' является числом, то он рассматривается как интервал в миллисекундах, с которым функция будет выполняться. Если ''polling'' представляет собой строку, это может быть одно из следующих значений:
      * ''raf'' - постоянно выполнять ''pageFunction'' в обратном вызове ''requestAnimationFrame'' . Это самый жесткий режим опроса, который подходит для наблюдения за изменениями стиля.
      * ''mutation'' - для выполнения ''pageFunction'' при каждой мутации DOM.
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] >> Promise, которое преобразуется в JSHandle значения успеха

**Этот метод устарел** . Вам следует использовать более явные доступные методы API:

  * ''page.waitForSelector''
  * ''page.waitForXPath''
  * ''page.waitForFunction''
  * ''page.waitForTimeout''

Этот метод ведет себя по-разному по отношению к типу первого параметра:

  * если ''selectorOrFunctionOrTimeout'' является ''string'' , то первый аргумент обрабатывается как [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|селектор]] или [[https://developer.mozilla.org/en-US/docs/Web/XPath|xpath]] , в зависимости от того, начинается ли он с %%'//'%%, а метод является ярлыком для [[#pagewaitforselectorselector-options|page.waitForSelector]] или [[#pagewaitforxpathxpath-options|page.waitForXPath]]
  * если ''selectorOrFunctionOrTimeout'' - ''function'' , то первый аргумент рассматривается как [[#pagewaitforfunctionpagefunction-options-args|ожидаемый]] предикат, а метод - это ярлык для page.waitForFunction () .
  * если ''selectorOrFunctionOrTimeout'' - это ''number'' , то первый аргумент обрабатывается как тайм-аут в миллисекундах, и метод возвращает обещание, которое разрешается по истечении тайм-аута.
  * в противном случае делается исключение

<code javascript>
// ждем селектора
await page.waitFor('.foo');
// ждем 1 секунду
await page.waitFor(1000);
// ждем предиката
await page.waitFor(() => !!document.querySelector('.foo'));
</code>

Чтобы передать аргументы из node.js в предикат функции ''page.waitFor'' :

<code javascript>
const selector = '.foo';
await page.waitFor(selector => !!document.querySelector(selector), {}, selector);
</code>

Ярлык для [[#framewaitforselectororfunctionortimeout-options-args|page.mainFrame (). WaitFor (selectorOrFunctionOrTimeout [, options [, ... args]])]] .

==== page.waitForFileChooser%%([%%options]) ====

  * ''options'' < [[####WaitTimeoutOptions|WaitTimeoutOptions]] > Необязательные параметры ожидания
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-filechooser|FileChooser]] >> Обещание, которое разрешается после того, как страница запрашивает средство выбора файлов.

> **ПРИМЕЧАНИЕ.** В Chromium без головы этот метод приводит к тому, что диалоговое окно выбора файлов **не отображается** для пользователя. 

Этот метод обычно сочетается с действием, запускающим выбор файла. В следующем примере щелкается кнопка, которая ''/tmp/myfile.pdf'' средство выбора файла , а затем отвечает /tmp/myfile.pdf, как если бы пользователь выбрал этот файл.

<code javascript>
const [fileChooser] = await Promise.all([
  page.waitForFileChooser(),
  page.click('#upload-file-button'), // какая-то кнопка, запускающая выбор файла
]);
await fileChooser.accept(['/tmp/myfile.pdf']);
</code>

> **Примечание** Это должно быть названо , прежде чем файл Chooser запускается. Он не вернет активный в данный момент выбор файла. 

==== page.waitForFunction(pageFunction[,options[,...args]])). ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция для оценки в контексте браузера
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
    * ''polling'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Интервал, с которым выполняется ''pageFunction'' , по умолчанию ''raf'' . Если ''polling'' является числом, то он рассматривается как интервал в миллисекундах, с которым функция будет выполняться. Если ''polling'' представляет собой строку, это может быть одно из следующих значений:
      * ''raf'' - постоянно выполнять ''pageFunction'' в обратном вызове ''requestAnimationFrame'' . Это самый жесткий режим опроса, который подходит для наблюдения за изменениями стиля.
      * ''mutation'' - для выполнения ''pageFunction'' при каждой мутации DOM.
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > максимальное время ожидания в миллисекундах. По умолчанию ''30000'' (30 секунд). Передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] >> Promise, которое разрешается, когда ''pageFunction'' возвращает истинное значение. Он разрешает JSHandle истинного значения.

Функция ''waitForFunction'' может использоваться для наблюдения за изменением размера области просмотра:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  const watchDog = page.waitForFunction('window.innerWidth < 100');
  await page.setViewport({width: 50, height: 50});
  await watchDog;
  await browser.close();
})();
</code>

Чтобы передать аргументы из node.js в предикат функции ''page.waitForFunction'' :

<code javascript>
const selector = '.foo';
await page.waitForFunction(selector => !!document.querySelector(selector), {}, selector);
</code>

Предикат ''page.waitForFunction'' также может быть асинхронным:

<code javascript>
const username = 'github-username';
await page.waitForFunction(async username => {
  const githubResponse = await fetch(`https://api.github.com/users/${username}`);
  const githubUser = await githubResponse.json();
  // показать аватар
  const img = document.createElement('img');
  img.src = githubUser.avatar_url;
  // ждем 3 секунды
  await new Promise((resolve, reject) => setTimeout(resolve, 3000));
  img.remove();
}, {}, username);
</code>

Ярлык для [[#framewaitforfunctionpagefunction-options-args|page.mainFrame (). WaitForFunction (pageFunction [, options [, ... args]])]] .

==== page.waitForNavigation%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Параметры навигации, которые могут иметь следующие свойства:
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время навигации в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaultnavigationtimeouttimeout|методов page.setDefaultNavigationTimeout (тайм-аут)]] или [[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout (тайм-аут)]] .
    * ''waitUntil'' <"load" | "domcontentloaded" | "networkidle0" | "networkidle2" | Array> Если считать, что навигация прошла успешно, по умолчанию используется ''load'' . Учитывая массив строк событий, навигация считается успешной после того, как все события были запущены. События могут быть:
      * ''load'' - считайте, что навигация завершена, когда запускается событие ''load'' .
      * ''domcontentloaded'' - считается, что навигация завершена, когда ''DOMContentLoaded'' событие DOMContentLoaded .
      * ''networkidle0'' - считать, что навигация завершена, если не более 0 сетевых подключений в течение не менее ''500'' мс.
      * ''networkidle2'' - считайте, что навигация завершена, если не более 2 сетевых подключений в течение не менее ''500'' мс.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-httpresponse|HTTPResponse]] >> Promise, которое разрешается в ответ основного ресурса. В случае нескольких перенаправлений навигация разрешится с ответом последнего перенаправления. В случае перехода к другой привязке или навигации из-за использования History API, переход будет разрешен с помощью ''null'' .

Это разрешается,когда страница переходит на новый URL или перезагружается.Это полезно,когда вы запускаете код,который косвенно вызывает навигацию по странице.Рассмотрим этот пример:

<code javascript>
const [response] = await Promise.all([
  page.waitForNavigation(), // Обещание разрешается после завершения навигации
  page.click('a.my-link'), // Нажатие на ссылку косвенно вызовет навигацию
]);
</code>

**ПРИМЕЧАНИЕ.** Использование [[https://developer.mozilla.org/en-US/docs/Web/API/History_API|History API]] для изменения URL-адреса считается навигацией.

Ярлык для [[#framewaitfornavigationoptions|page.mainFrame (). WaitForNavigation (параметры)]] .

==== page.waitForRequest(urlOrPredicate[,опции])) ====

  * ''urlOrPredicate'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|Функция]] > URL-адрес или предикат для ожидания.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время ожидания в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-httprequest|HTTPRequest]] >> Promise, которое разрешается в согласованный запрос.

<code javascript>
const firstRequest = await page.waitForRequest('http://example.com/resource');
const finalRequest = await page.waitForRequest(request => request.url() === 'http://example.com' && request.method() === 'GET');
return firstRequest.url();
</code>

==== page.waitForResponse(urlOrPredicate[,опции])) ====

  * ''urlOrPredicate'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|Функция]] > URL-адрес или предикат для ожидания.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время ожидания в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-httpresponse|HTTPResponse]] >> Promise, которое разрешается в совпавший ответ.

<code javascript>
const firstResponse = await page.waitForResponse('https://example.com/resource');
const finalResponse = await page.waitForResponse(response => response.url() === 'https://example.com' && response.status() === 200);
const finalResponse = await page.waitForResponse(async response => { return (await response.text()).includes('<html>') })
return finalResponse.ok();
</code>

==== page.waitForSelector(selector[,options])) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] элемента для ожидания
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
    * ''visible'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > ожидает, пока элемент будет присутствовать в DOM и станет видимым, то есть не будет иметь свойств CSS ''display: none'' или ''visibility: hidden'' . По умолчанию - ''false'' .
    * ''hidden'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > подождите, пока элемент не будет найден в DOM или будет скрыт, т.е. будет иметь свойства CSS ''display: none'' или ''visibility: hidden'' . По умолчанию - ''false'' .
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > максимальное время ожидания в миллисекундах. По умолчанию ''30000'' (30 секунд). Передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-elementhandle|ElementHandle]] >> Promise, которое разрешается, когда элемент, указанный в строке селектора, добавляется в DOM. Преобразуется в ''null'' , если ожидание ''hidden: true'' и селектор не найден в DOM.

Подождите, пока на странице появится ''selector'' . Если на момент вызова метода ''selector'' уже существует, метод немедленно вернется. Если селектор не появляется после истечения времени ''timeout'' миллисекундах, функция сгенерирует.

Этот метод работает во всех навигациях:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  let currentURL;
  page
    .waitForSelector('img')
    .then(() => console.log('First URL with image: ' + currentURL));
  for (currentURL of ['https://example.com', 'https://google.com', 'https://bbc.com']) {
    await page.goto(currentURL);
  }
  await browser.close();
})();
</code>

Ярлык для [[#framewaitforselectorselector-options|page.mainFrame (). WaitForSelector (селектор [, параметры])]] .

==== page.waitForTimeout(milliseconds) ====

  * ''milliseconds'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Количество миллисекунд ожидания.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается по истечении тайм-аута.

Приостанавливает выполнение сценария на заданное количество миллисекунд перед продолжением:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  page.waitForTimeout(1000)
    .then(() => console.log('Waited a second!'));

  await browser.close();
})();
</code>

==== page.waitForXPath(xpath[,опции])) ====

  * ''xpath'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/XPath|xpath]] элемента для ожидания
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
    * ''visible'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > ожидает, пока элемент будет присутствовать в DOM и станет видимым, то есть не будет иметь свойств CSS ''display: none'' или ''visibility: hidden'' . По умолчанию - ''false'' .
    * ''hidden'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > подождите, пока элемент не будет найден в DOM или будет скрыт, т.е. будет иметь свойства CSS ''display: none'' или ''visibility: hidden'' . По умолчанию - ''false'' .
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > максимальное время ожидания в миллисекундах. По умолчанию ''30000'' (30 секунд). Передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-elementhandle|ElementHandle]] >> Promise, которое разрешается, когда элемент, указанный в строке xpath, добавляется в DOM. Преобразуется в ''null'' , если ожидает ''hidden: true'' и xpath не найден в DOM.

Подождите, пока ''xpath'' не появится на странице. Если на момент вызова метода ''xpath'' уже существует, метод немедленно вернется. Если xpath не появляется после истечения времени ''timeout'' миллисекундах, функция сгенерирует.

Этот метод работает во всех навигациях:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  let currentURL;
  page
    .waitForXPath('//img')
    .then(() => console.log('First URL with image: ' + currentURL));
  for (currentURL of ['https://example.com', 'https://google.com', 'https://bbc.com']) {
    await page.goto(currentURL);
  }
  await browser.close();
})();
</code>

Ярлык для [[#framewaitforxpathxpath-options|page.mainFrame (). WaitForXPath (xpath [, параметры])]] .

==== page.workers() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-webworker|WebWorker]] >> Этот метод возвращает всех выделенных [[https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API|WebWorkers,]] связанных со страницей.

> **ПРИМЕЧАНИЕ.** Не содержит ServiceWorkers. 

==== GeolocationOptions ====

  * ''latitude'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Широта от -90 до 90.
  * ''longitude'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Долгота от -180 до 180.
  * ''accuracy'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Необязательное неотрицательное значение точности.

==== WaitTimeoutOptions ====

  * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время ожидания в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .

===== class: WebWorker =====

Класс WebWorker представляет [[https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API|WebWorker]] . События ''workercreated'' и ''workerdestroyed'' генерируются на объекте страницы, чтобы сигнализировать о жизненном цикле worker.

<code javascript>
page.on('workercreated', worker => console.log('Worker created: ' + worker.url()));
page.on('workerdestroyed', worker => console.log('Worker destroyed: ' + worker.url()));

console.log('Current workers:');
for (const worker of page.workers())
  console.log('  ' + worker.url());
</code>

==== webWorker.evaluate(pageFunction[, ...args]) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция, которая будет оцениваться в рабочем контексте
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Если функция, переданная в ''worker.evaluate'' , возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , то ''worker.evaluate'' будет ждать, пока обещание разрешится, и вернет свое значение.

Если функция передается ''worker.evaluate'' возвращает значение не [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] значения, то ''worker.evaluate'' ПОСТАНОВЛЯЕТ ''undefined'' . Протокол DevTools также поддерживает передачу некоторых дополнительных значений, не сериализуемых с помощью ''JSON'' : ''-0'' , ''NaN'' , ''Infinity'' , ''-Infinity'' и литералы bigint.

Ярлык для [[#executioncontextevaluatepagefunction-args|(await worker.executionContext ()). Assessment (pageFunction, ... args)]] .

==== webWorker.evaluateHandle(pageFunction[, ...args]) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция, которая будет оцениваться в контексте страницы
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] | [[#class-elementhandle|ElementHandle]] >> Promise, которое ''pageFunction'' в возвращаемое значение pageFunction как внутристраничный объект.

Единственная разница между ''worker.evaluate'' и ''worker.evaluateHandle'' заключается в том, что ''worker.evaluateHandle'' возвращает объект на странице (JSHandle).

Если функция, переданная в ''worker.evaluateHandle'' , возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|обещание]] , то ''worker.evaluateHandle'' будет ждать разрешения обещания и вернет его значение.

Если функция возвращает элемент, возвращаемый дескриптор - [[#class-elementhandle|ElementHandle]] .

Ярлык для [[#executioncontextevaluatehandlepagefunction-args|(await worker.executionContext ()). AssessmentHandle (pageFunction, ... args)]] .

==== webWorker.executionContext() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-executioncontext|ExecutionContext]] >>

==== webWorker.url() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

===== Класс:Доступность =====

Класс доступности предоставляет методы для проверки дерева доступности Chromium. Дерево специальных возможностей используется вспомогательными технологиями, такими как [[https://en.wikipedia.org/wiki/Screen_reader|программы чтения с экрана]] или [[https://en.wikipedia.org/wiki/Switch_access|переключатели]] .

Доступность-это очень специфическая для платформы вещь.На разных платформах есть разные скринридеры,которые могут иметь дико разный вывод.

Blink-движок рендеринга Chrome-имеет концепцию "дерева доступности",которая затем преобразуется в различные API,специфичные для конкретной платформы.Пространство имен Accessibility предоставляет пользователям доступ к дереву доступности Blink.

Большая часть дерева доступности отфильтровывается при преобразовании из Blink AX Tree в AX-Tree для конкретной платформы или с помощью вспомогательных технологий.По умолчанию кукловод пытается аппроксимировать эту фильтрацию,выставляя только "интересные" узлы дерева.

==== accessibility.snapshot%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''interestingOnly'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Удалите из дерева неинтересные узлы. По умолчанию ''true'' .
    * ''root'' < [[#class-elementhandle|ElementHandle]] > Корневой элемент DOM для моментального снимка. По умолчанию для всей страницы.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Объект [[#accessibilitysnapshotoptions|AXNode]] со следующими свойствами:
    * ''role'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://www.w3.org/TR/wai-aria/#usage_intro|Роль]] .
    * ''name'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Имя узла, читаемое человеком.
    * ''value'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Текущее значение узла.
    * ''description'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Дополнительное удобочитаемое описание узла.
    * ''keyshortcuts'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Сочетания клавиш, связанные с этим узлом.
    * ''roledescription'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Удобочитаемая альтернатива роли.
    * ''valuetext'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Описание текущего значения.
    * ''disabled'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Отключен ли узел.
    * ''expanded'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логический]] > Развернут или свернут узел.
    * ''focused'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Указывает, находится ли узел в фокусе.
    * ''modal'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Является ли узел [[https://en.wikipedia.org/wiki/Modal_window|модальным]] .
    * ''multiline'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Поддерживает ли ввод текста узла многострочность.
    * ''multiselectable'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Можно ли выбрать более одного дочернего элемента .
    * ''readonly'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Доступен ли узел только для чтения.
    * ''required'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Требуется ли узел.
    * ''selected'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Выбран ли узел в его родительском узле.
    * ''checked'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] | "смешанный"> Независимо от того, установлен ли флажок, или "смешанный".
    * ''pressed'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] | "смешанное"> Независимо от того, отмечен ли переключатель, или "смешанный".
    * ''level'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Уровень заголовка.
    * ''valuemin'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Минимальное значение в узле.
    * ''valuemax'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное значение в узле.
    * ''autocomplete'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Какой вид автозаполнения поддерживает элемент управления.
    * ''haspopup'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Какого рода всплывающее окно отображается в данный момент для узла.
    * ''invalid'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Является ли значение этого узла недопустимым и каким образом.
    * ''orientation'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Ориентирован ли узел горизонтально или вертикально.
    * ''children'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Дочерние [[#accessibilitysnapshotoptions|узлы AXNode]] этого узла, если таковые имеются.

Запечатлевает текущее состояние дерева доступности.Возвращаемый объект представляет собой корневой доступный узел страницы.

> **ПРИМЕЧАНИЕ** . Дерево доступности Chromium содержит узлы, которые не используются на большинстве платформ и большинством программ чтения с экрана. Кукловод также отбрасывает их, чтобы упростить обработку дерева, если для параметра ''interestingOnly'' установлено значение ''false'' . 

Пример сброса всего дерева доступности:

<code javascript>
const snapshot = await page.accessibility.snapshot();
console.log(snapshot);
</code>

Пример регистрации имени сфокусированного узла:

<code javascript>
const snapshot = await page.accessibility.snapshot();
const node = findFocusedNode(snapshot);
console.log(node && node.name);

function findFocusedNode(node) {
  if (node.focused)
    return node;
  for (const child of node.children || []) {
    const foundNode = findFocusedNode(child);
    return foundNode;
  }
  return null;
}
</code>

===== Класс:Клавиатура =====

Клавиатура предоставляет API для управления виртуальной клавиатурой. API высокого уровня - это ''[[#keyboardtypetext-options|keyboard.type]]'' , который принимает необработанные символы и генерирует правильные события нажатия клавиш, нажатия / ввода и нажатия клавиш на вашей странице.

Для более точного управления вы можете использовать ''[[#keyboarddownkey-options|keyboard.down]]'' , ''[[#keyboardupkey|keyboard.up]]'' и ''[[#keyboardsendcharacterchar|keyboard.sendCharacter]]''[[#keyboardsendcharacterchar| ,]] чтобы вручную запускать события, как если бы они были сгенерированы с реальной клавиатуры.

Пример удерживания ''Shift'' для выделения и удаления текста:

<code javascript>
await page.keyboard.type('Hello World!');
await page.keyboard.press('ArrowLeft');

await page.keyboard.down('Shift');
for (let i = 0; i < ' World'.length; i++)
  await page.keyboard.press('ArrowLeft');
await page.keyboard.up('Shift');

await page.keyboard.press('Backspace');
// В результате в тексте результата будет написано «Привет!»
</code>

Пример нажатия ''A''

<code javascript>
await page.keyboard.down('Shift');
await page.keyboard.press('KeyA');
await page.keyboard.up('Shift');
</code>

> **ПРИМЕЧАНИЕ** В MacOS такие сочетания клавиш, как ''⌘ A'' -> Выбрать все, не работают. См. [[https://github.com/puppeteer/puppeteer/issues/1313|№ 1313]] 

==== keyboard.down(key[,options])) ====

  * ''key'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Имя клавиши, которую нужно нажать, например ''ArrowLeft'' . См. Список всех имен клавиш в [[https://github.com/puppeteer/puppeteer/blob/v7.1.0/src/common/USKeyboardLayout.ts|USKeyboardLayout]] .
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''text'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Если указано, генерирует событие ввода с этим текстом.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отправляет событие ''keydown'' .

Если ''key'' представляет собой одиночный символ и никакие клавиши-модификаторы, кроме ''Shift'' , не удерживаются, также будет сгенерировано событие ''keypress'' / ''input'' . ''text'' опция может быть указана , чтобы заставить событие ввода , который будет создан.

Если ''key'' является клавишей- модификатором, ''Shift'' , ''Meta'' , ''Control'' или ''Alt'' , последующие нажатия клавиш будут отправляться с активным модификатором. Чтобы отпустить клавишу-модификатор, используйте ''[[#keyboardupkey|keyboard.up]]'' .

После однократного нажатия клавиши при последующих вызовах ''[[#keyboarddownkey-options|keyboard.down]]'' для параметра [[https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/repeat|repeat]] будет установлено значение true. Чтобы отпустить клавишу, используйте ''[[#keyboardupkey|keyboard.up]]'' .

> **ПРИМЕЧАНИЕ** Клавиши-модификаторы ДЕЙСТВИТЕЛЬНО влияют на раскручивание ''keyboard.down'' . Удерживая нажатой ''Shift'' вы набираете текст в верхнем регистре. 

==== keyboard.press(key[,options])) ====

  * ''key'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Имя клавиши, которую нужно нажать, например ''ArrowLeft'' . См. Список всех имен клавиш в [[https://github.com/puppeteer/puppeteer/blob/v7.1.0/src/common/USKeyboardLayout.ts|USKeyboardLayout]] .
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''text'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Если указано, генерирует событие ввода с этим текстом.
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Время ожидания между ''keydown'' и ''keyup'' в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Если ''key'' представляет собой одиночный символ и никакие клавиши-модификаторы, кроме ''Shift'' , не удерживаются, также будет сгенерировано событие ''keypress'' / ''input'' . ''text'' опция может быть указана , чтобы заставить событие ввода , который будет создан.

> **ПРИМЕЧАНИЕ** Клавиши-модификаторы ДЕЙСТВИТЕЛЬНО влияют на ''keyboard.press'' . Удерживая нажатой ''Shift'' вы набираете текст в верхнем регистре. 

Сочетание клавиш для ''[[#keyboarddownkey-options|keyboard.down]]'' и ''[[#keyboardupkey|keyboard.up]]'' .

==== keyboard.sendCharacter(char) ====

  * ''char'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Символ для отправки на страницу.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отправляет событие ''keypress'' и ''input'' . Это не отправляет событие ''keydown'' или ''keyup'' .

<code javascript>
page.keyboard.sendCharacter('嗨');
</code>

> **ПРИМЕЧАНИЕ** Клавиши-модификаторы НЕ влияют на ''keyboard.sendCharacter'' . Удерживание ''Shift'' не приведет к вводу текста в верхнем регистре. 

==== keyboard.type(text[,options])) ====

  * ''text'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Текст для ввода в выбранный элемент.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Время ожидания между нажатиями клавиш в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Посылает ''keydown'' , ''keypress'' / ''input'' и ''keyup'' событие для каждого символа в тексте.

Чтобы нажать специальную клавишу, например ''Control'' или ''ArrowDown'' , используйте ''[[#keyboardpresskey-options|keyboard.press]]'' .

<code javascript>
await page.keyboard.type('Hello'); // Мгновенно набирает
await page.keyboard.type('World', {delay: 100}); // Набирает медленнее, как пользователь
</code>

> **ПРИМЕЧАНИЕ** Клавиши-модификаторы НЕ влияют на ''keyboard.type'' . Удерживание ''Shift'' не приведет к вводу текста в верхнем регистре. 

==== keyboard.up(key) ====

  * ''key'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Имя клавиши, которую нужно освободить, например ''ArrowLeft'' . См. Список всех имен клавиш в [[https://github.com/puppeteer/puppeteer/blob/v7.1.0/src/common/USKeyboardLayout.ts|USKeyboardLayout]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отправляет событие ''keyup'' .

===== Класс:Мышь =====

Класс Мышь работает в пикселях CSS основного кадра относительно левого верхнего угла вью-порта.

Каждый объект ''page'' имеет свою собственную мышь, доступную с помощью ''[[#pagemouse|page.mouse]]'' .

<code javascript>
// Использование page.mouse для обведения квадрата 100x100.
await page.mouse.move(0, 0);
await page.mouse.down();
await page.mouse.move(0, 100);
await page.mouse.move(100, 100);
await page.mouse.move(100, 0);
await page.mouse.move(0, 0);
await page.mouse.up();
</code>

Обратите внимание, что события мыши запускают синтетические ''MouseEvent'' s. Это означает, что он не полностью воспроизводит функциональность того, что обычный пользователь мог бы делать с помощью своей мыши.

Например, перетаскивание и выделение текста невозможно с помощью ''page.mouse'' . Вместо этого вы можете использовать функциональность ''[[https://developer.mozilla.org/en-US/docs/Web/API/DocumentOrShadowRoot/getSelection|DocumentOrShadowRoot.getSelection()]]'' реализованную на платформе.

Например,если вы хотите выбрать все содержимое между узлами:

<code javascript>
await page.evaluate((from, to) => {
  const selection = from.getRootNode().getSelection();
  const range = document.createRange();
  range.setStartBefore(from);
  range.setEndAfter(to);
  selection.removeAllRanges();
  selection.addRange(range);
}, fromJSHandle, toJSHandle);
</code>

Если вы хотите скопировать-вставить выделение,вы можете использовать апи буфера обмена:

<code javascript>
// API буфера обмена не позволяет вам копировать, если вкладка не сфокусирована.
await page.bringToFront();
await page.evaluate(() => {
  // Копируем выделенный контент в буфер обмена
  document.execCommand('copy');
  // Получаем содержимое буфера обмена в виде строки
  return navigator.clipboard.readText();
});
</code>

Обратите внимание,что если вы хотите получить доступ к API буфера обмена,вы должны дать ему соответствующее разрешение:

<code javascript>
await browser.defaultBrowserContext().overridePermissions('<your origin>', ['clipboard-read', 'clipboard-write']);
</code>

==== mouse.click(x,y[,опции]). ====

  * ''x'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
  * ''y'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''button'' <"left" | "right" | "middle"> По умолчанию ''left'' .
    * ''clickCount'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > по умолчанию [[https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail|равен]] 1. См. UIEvent.detail .
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Время ожидания между ''mousedown'' и ''mouseup'' в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Ярлыки для ''[[#mousemovex-y-options|mouse.move]]'' , ''[[#mousedownoptions|mouse.down]]'' и ''[[#mouseupoptions|mouse.up]]'' .

==== mouse.down%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''button'' <"left" | "right" | "middle"> По умолчанию ''left'' .
    * ''clickCount'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > по умолчанию [[https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail|равен]] 1. См. UIEvent.detail .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отправляет событие ''mousedown'' .

==== mouse.move(x,y[,опции)) ====

  * ''x'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
  * ''y'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''steps'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > по умолчанию 1. Посылает промежуточные события ''mousemove'' .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отправляет событие ''mousemove'' .

==== mouse.up%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''button'' <"left" | "right" | "middle"> По умолчанию ''left'' .
    * ''clickCount'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > по умолчанию [[https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail|равен]] 1. См. UIEvent.detail .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отправляет событие ''mouseup'' .

==== mouse.wheel%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''deltaX'' X дельта в пикселях CSS для события колеса мыши (по умолчанию: 0). Положительные значения имитируют прокрутку вправо, а отрицательные значения - событие прокрутки влево.
    * ''deltaY'' Y дельта в пикселях CSS для события колеса мыши (по умолчанию: 0). Положительные значения имитируют прокрутку вниз, а отрицательные значения - событие прокрутки вверх.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отправляет событие ''mousewheel'' .

Examples:

<code javascript>
await page.goto('https://mdn.mozillademos.org/en-US/docs/Web/API/Element/wheel_event$samples/Scaling_an_element_via_the_wheel?revision=1587366');

const elem = await page.$('div');
const boundingBox = await elem.boundingBox();
await page.mouse.move(
  boundingBox.x + boundingBox.width / 2,
  boundingBox.y + boundingBox.height / 2
);

await page.mouse.wheel({ deltaY: -100 })
</code>

===== Класс:Сенсорный экран =====

==== сенсорный экран.tap(x,y) ====

  * ''x'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
  * ''y'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отправляет ''touchstart'' и ''touchend'' .

===== Класс:Отслеживание =====

Вы можете использовать ''[[#tracingstartoptions|tracing.start]]'' и ''[[#tracingstop|tracing.stop]]'' для создания файла трассировки, который можно открыть в Chrome DevTools или программе [[https://chromedevtools.github.io/timeline-viewer/|просмотра временной шкалы]] .

<code javascript>
await page.tracing.start({path: 'trace.json'});
await page.goto('https://www.google.com');
await page.tracing.stop();
</code>

==== tracing.start%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Путь для записи файла трассировки.
    * ''screenshots'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > делает снимки экрана в трассировке.
    * ''categories'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> указывают настраиваемые категории для использования вместо категорий по умолчанию.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Одновременно может быть активна только одна трасса на один браузер.

==== tracing.stop() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://nodejs.org/api/buffer.html#buffer_class_buffer|Buffer]] >> Promise, которое разрешается в буфер с данными трассировки.

===== Класс:FileChooser =====

Объекты FileChooser возвращаются с помощью метода [[#pagewaitforfilechooseroptions|page.waitForFileChooser]] .

Выбор файлов позволяет реагировать на запрос страницы файла.

Пример использования [[#class-filechooser|FileChooser]] :

<code javascript>
const [fileChooser] = await Promise.all([
  page.waitForFileChooser(),
  page.click('#upload-file-button'), // какая-то кнопка, запускающая выбор файла
]);
await fileChooser.accept(['/tmp/myfile.pdf']);
</code>

> **ПРИМЕЧАНИЕ.** В браузерах одновременно может быть открыт только один селектор файлов. Все средства выбора файлов должны быть приняты или отменены. Если этого не сделать, то последующие средства выбора файлов не появятся. 

==== fileChooser.accept(filePaths) ====

  * ''filePaths'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Принять запрос средства выбора файла с заданными путями. Если некоторые из ''filePaths'' путей являются относительными путями, они разрешаются относительно [[https://nodejs.org/api/process.html#process_process_cwd|текущего рабочего каталога]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

==== fileChooser.cancel() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Закрывает выбор файла без выбора файлов.

==== fileChooser.isMultiple() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Допускает ли средство выбора файлов выбор [[https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#attr-multiple|нескольких]] файлов.

===== Класс:Диалог =====

Объекты диалогов отправляются по страницам с помощью события [[#event-dialog|'dialog']] .

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

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  page.on('dialog', async dialog => {
    console.log(dialog.message());
    await dialog.dismiss();
    await browser.close();
  });
  page.evaluate(() => alert('1'));
})();
</code>

==== dialog.accept%%([%%promptText]) ====

  * ''promptText'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Текст для ввода в подсказку. Не вызывает никаких эффектов, если ''type'' диалога не является подсказкой.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается, когда диалог был принят.

==== dialog.defaultValue() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Если диалоговое окно является приглашением, возвращает значение приглашения по умолчанию. В противном случае возвращает пустую строку.

==== dialog.dismiss() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается, когда диалоговое окно было закрыто.

==== dialog.message() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Сообщение, отображаемое в диалоговом окне.

==== dialog.type() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Тип диалога может быть одним из ''alert'' , ''beforeunload'' , ''confirm'' или ''prompt'' .

===== Класс:Консольное сообщение =====

Объекты ConsoleMessage отправляются постранично через событие [[#event-console|console]] .

==== consoleMessage.args() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-jshandle|JSHandle]] >>

==== consoleMessage.location() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > URL-адрес ресурса, если он известен, или ''undefined'' противном случае.
    * ''lineNumber'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > отсчитываемый от 0 номер строки в ресурсе, если он известен, или ''undefined'' противном случае.
    * ''columnNumber'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Отсчитываемый от 0 номер столбца в ресурсе, если известен, или ''undefined'' противном случае.

==== consoleMessage.stackTrace() ====

  * returns: <[[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]]<[[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]]>>
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > URL-адрес ресурса, если он известен, или ''undefined'' противном случае.
    * ''lineNumber'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > отсчитываемый от 0 номер строки в ресурсе, если он известен, или ''undefined'' противном случае.
    * ''columnNumber'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Отсчитываемый от 0 номер столбца в ресурсе, если известен, или ''undefined'' противном случае.

==== consoleMessage.text() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

==== consoleMessage.type() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

Одно из следующих значений: '''log''' , '''debug''' , '''info''' , '''error''' , '''warning''' , '''dir''' , '''dirxml''' , '''table''' , '''trace''' , '''clear''' , '''startGroup''' , '''startGroupCollapsed''' , '''endGroup''' , '''assert''' , '''profile''' , '''profileEnd''' , '''count''' , '''timeEnd''' .

===== Класс:Фрейм =====

В каждый момент времени страница предоставляет свое текущее дерево фреймов с помощью [[#pagemainframe|методов page.mainFrame ()]] и [[#framechildframes|frame.childFrames ()]] .

Жизненный цикл объекта кадра контролируется тремя событиями, отправляемыми объекту страницы:

  * [[#event-frameattached|'frameattached']] - запускается, когда фрейм прикрепляется к странице. Рамку можно прикрепить к странице только один раз.
  * [[#event-framenavigated|'framenavigated']] - запускается, когда фрейм совершает переход по другому URL-адресу.
  * [[#event-framedetached|'framedetached']] - срабатывает, когда фрейм отделяется от страницы. Фрейм можно отсоединить от страницы только один раз.

Пример сбрасывания каркасного дерева:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://www.google.com/chrome/browser/canary.html');
  dumpFrameTree(page.mainFrame(), '');
  await browser.close();

  function dumpFrameTree(frame, indent) {
    console.log(indent + frame.url());
    for (const child of frame.childFrames()) {
      dumpFrameTree(child, indent + '  ');
    }
  }
})();
</code>

Пример получения текста из элемента iframe:

<code javascript>
const frame = page.frames().find(frame => frame.name() === 'myframe');
const text = await frame.$eval('.selector', element => element.textContent);
console.log(text);
</code>

==== frame.$(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса кадра для
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-elementhandle|ElementHandle]] >> Promise, которое преобразуется в ElementHandle, указывающую на элемент кадра.

Метод запрашивает кадр для селектора. Если в кадре такого элемента нет, метод принимает значение ''null'' .

==== frame.$$(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса кадра для
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-elementhandle|ElementHandle]] >>> Promise, которое преобразуется в ElementHandles, указывающую на элементы кадра.

Метод запускает ''document.querySelectorAll'' внутри фрейма. Если ни один элемент не соответствует селектору, возвращаемое значение преобразуется в ''[]'' .

==== frame.$$eval(селектор,функция pageFunction[,...args])) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса кадра для
  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/API/element|Element]] >)> Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Этот метод запускает ''Array.from(document.querySelectorAll(selector))'' внутри кадра и передает его в качестве первого аргумента функции ''pageFunction'' .

Если ''pageFunction'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , то ''frame.$$eval'' будет ждать разрешения обещания и вернет его значение.

Examples:

<code javascript>
const divsCounts = await frame.$$eval('div', divs => divs.length);
</code>

==== frame.$eval(селектор,pageFunction[,...args])) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса кадра для
  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[https://developer.mozilla.org/en-US/docs/Web/API/element|Element]] )> Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Этот метод запускает ''document.querySelector'' во фрейме и передает его в качестве первого аргумента ''pageFunction'' . Если нет ''selector'' соответствия элемента , метод выдает ошибку.

Если ''pageFunction'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|обещание]] , то ''frame.$eval'' будет ждать разрешения обещания и вернет его значение.

Examples:

<code javascript>
const searchValue = await frame.$eval('#search', el => el.value);
const preloadHref = await frame.$eval('link[rel=preload]', el => el.href);
const html = await frame.$eval('.main-container', e => e.outerHTML);
</code>

==== frame.$x(expression) ====

  * ''expression'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Выражение для [[https://developer.mozilla.org/en-US/docs/Web/API/Document/evaluate|оценки]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-elementhandle|ElementHandle]] >>>

Метод оценивает выражение XPath относительно документа фрейма как контекстного узла.Если таких элементов нет,метод преобразуется в пустой массив.

==== frame.addScriptTag(options) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > URL-адрес добавляемого скрипта.
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Путь к файлу JavaScript, который будет вставлен во фрейм. Если ''path'' является относительным путем, он разрешается относительно [[https://nodejs.org/api/process.html#process_process_cwd|текущего рабочего каталога]] .
    * ''content'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Необработанный контент JavaScript для вставки во фрейм.
    * ''type'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Тип скрипта. Используйте «модуль», чтобы загрузить модуль Javascript ES6. Смотрите [[https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script|сценарий]] для более подробной информации.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-elementhandle|ElementHandle]] >>, который разрешается в добавленный тег, когда запускается загрузка скрипта или когда содержимое скрипта было вставлено во фрейм.

Добавляет ''<script>'' на страницу с желаемым URL-адресом или содержимым.

==== frame.addStyleTag(options) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > URL ''<link>'' .
    * ''path'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Путь к файлу CSS, который будет вставлен во фрейм. Если ''path'' является относительным путем, он разрешается относительно [[https://nodejs.org/api/process.html#process_process_cwd|текущего рабочего каталога]] .
    * ''content'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Необработанное содержимое CSS для вставки во фрейм.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-elementhandle|ElementHandle]] >>, который преобразуется в добавленный тег, когда срабатывает загрузка таблицы стилей или когда содержимое CSS было вставлено во фрейм.

Добавляет ''<link rel="stylesheet">'' на страницу с желаемым URL-адресом или ''<style type="text/css">'' с содержимым.

==== frame.childFrames() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-frame|Frame]] >>

==== кадр.click (селектор[,опции]) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для поиска элемента, который нужно щелкнуть. Если есть несколько элементов, удовлетворяющих селектору, будет выбран первый.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''button'' <"left" | "right" | "middle"> По умолчанию ''left'' .
    * ''clickCount'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > по умолчанию [[https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail|равен]] 1. См. UIEvent.detail .
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Время ожидания между ''mousedown'' и ''mouseup'' в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается при успешном щелчке по ''selector'' соответствия элемента . Обещание будет отклонено, если нет ''selector'' соответствия элемента .

Этот метод выбирает элемент с помощью ''selector'' , при необходимости прокручивает его, а затем использует [[#pagemouse|page.mouse]] для щелчка в центре элемента. Если нет ''selector'' соответствия элемента , метод выдает ошибку.

Имейте в виду, что если ''click()'' запускает событие навигации и есть отдельное ''page.waitForNavigation()'' которое должно быть разрешено, вы можете получить состояние гонки, которое приведет к неожиданным результатам. Правильный шаблон для щелчка и ожидания навигации следующий:

<code javascript>
const [response] = await Promise.all([
  page.waitForNavigation(waitOptions),
  frame.click(selector, clickOptions),
]);
</code>

==== frame.content() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >>

Получает полное HTML содержимое кадра,включая тип doctype.

==== frame.assess(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Если функция, переданная в ''frame.evaluate'' , возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , то ''frame.evaluate'' будет ждать разрешения обещания и вернет свое значение.

Если функция перешла к ''frame.evaluate'' возвращает значение не [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] значения, то ''frame.evaluate'' ПОСТАНОВЛЯЕТ ''undefined'' . Протокол DevTools также поддерживает передачу некоторых дополнительных значений, не сериализуемых с помощью ''JSON'' : ''-0'' , ''NaN'' , ''Infinity'' , ''-Infinity'' и литералы bigint.

<code javascript>
const result = await frame.evaluate(() => {
  return Promise.resolve(8 * 7);
});
console.log(result); // prints "56"
</code>

Также вместо функции может быть передана строка.

<code javascript>
console.log(await frame.evaluate('1 + 2')); // prints "3"
</code>

Экземпляры ElementHandle могут быть переданы в качестве аргументов в ''frame.evaluate'' :

<code javascript>
const bodyHandle = await frame.$('body');
const html = await frame.evaluate(body => body.innerHTML, bodyHandle);
await bodyHandle.dispose();
</code>

==== frame.assessHandle(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция, которая будет оцениваться в контексте страницы
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] | [[#class-elementhandle|ElementHandle]] >> Promise, которое ''pageFunction'' в возвращаемое значение pageFunction как внутристраничный объект.

Единственная разница между ''frame.evaluate'' и ''frame.evaluateHandle'' состоит в том, что ''frame.evaluateHandle'' возвращает объект на странице (JSHandle).

Если функция, переданная в ''frame.evaluateHandle'' , возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , то ''frame.evaluateHandle'' будет ждать разрешения обещания и вернет его значение.

Если функция возвращает элемент, возвращаемый дескриптор - [[#class-elementhandle|ElementHandle]] .

<code javascript>
const aWindowHandle = await frame.evaluateHandle(() => Promise.resolve(window));
aWindowHandle; // Handle for the window object.
</code>

Также вместо функции может быть передана строка.

<code javascript>
const aHandle = await frame.evaluateHandle('document'); // Дескриптор документа.
</code>

[[#class-jshandle|Экземпляры JSHandle]] можно передать в качестве аргументов в ''frame.evaluateHandle'' :

<code javascript>
const aHandle = await frame.evaluateHandle(() => document.body);
const resultHandle = await frame.evaluateHandle(body => body.innerHTML, aHandle);
console.log(await resultHandle.jsonValue());
await resultHandle.dispose();
</code>

==== frame.executionContext() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-executioncontext|ExecutionContext]] >>

Возвращает обещание,которое разрешает контекст выполнения фрейма по умолчанию.

==== frame.focus(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] элемента, на который нужно сфокусироваться. Если есть несколько элементов, удовлетворяющих селектору, первый будет сфокусирован.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается, когда ''selector'' сопоставления элементов успешно сфокусирован. Обещание будет отклонено, если нет ''selector'' соответствия элементов .

Этот метод выбирает элемент с помощью ''selector'' и фокусирует его. Если нет ''selector'' соответствия элемента , метод выдает ошибку.

==== frame.goto(url[,опции]) ====

  * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > URL для перехода к фрейму. URL-адрес должен включать схему, например %%''https://''%% .
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Параметры навигации, которые могут иметь следующие свойства:
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время навигации в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaultnavigationtimeouttimeout|методов page.setDefaultNavigationTimeout (тайм-аут)]] или [[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout (тайм-аут)]] .
    * ''waitUntil'' <"load" | "domcontentloaded" | "networkidle0" | "networkidle2" | Array> Если считать, что навигация прошла успешно, по умолчанию используется ''load'' . Учитывая массив строк событий, навигация считается успешной после того, как все события были запущены. События могут быть:
      * ''load'' - считайте, что навигация завершена, когда запускается событие ''load'' .
      * ''domcontentloaded'' - считается, что навигация завершена, когда ''DOMContentLoaded'' событие DOMContentLoaded .
      * ''networkidle0'' - считать, что навигация завершена, если не более 0 сетевых подключений в течение не менее ''500'' мс.
      * ''networkidle2'' - считайте, что навигация завершена, если не более 2 сетевых подключений в течение не менее ''500'' мс.
    * ''referer'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Значение заголовка Referer. Если он предоставлен, он будет иметь приоритет над значением заголовка [[#pagesetextrahttpheadersheaders|реферера,]] установленным page.setExtraHTTPHeaders () .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-httpresponse|HTTPResponse]] >> Promise, которое разрешается в ответ основного ресурса. В случае нескольких перенаправлений навигация разрешится с ответом последнего перенаправления.

''frame.goto'' выдаст ошибку, если:

  * есть ошибка SSL (например,в случае самоподписанных сертификатов).
  * целевой URL-адрес недействителен.
  * время ''timeout'' превышено во время навигации.
  * удаленный сервер не отвечает или недоступен.
  * основной ресурс не загрузился.

''frame.goto'' не выдаст ошибку, если удаленный сервер вернет любой допустимый код состояния HTTP, включая 404 «Не найдено» и 500 «Внутренняя ошибка сервера». Код состояния для таких ответов можно получить, вызвав [[#httpresponsestatus|response.status ()]] .

> **ПРИМЕЧАНИЕ** ''frame.goto'' либо выдает ошибку, либо возвращает ответ основного ресурса. Единственными исключениями являются переход к ''about:blank'' или переход к тому же URL-адресу с другим хешем, который завершится успешно и вернет ''null'' . 

> **ПРИМЕЧАНИЕ.** Режим «Без заголовка» не поддерживает переход к документу PDF. См. Проблему с [[https://bugs.chromium.org/p/chromium/issues/detail?id=761295|восходящим потоком]] . 

==== frame.hover(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для поиска элемента для наведения. Если есть несколько элементов, удовлетворяющих селектору, первый будет зависать.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается, когда ''selector'' соответствия элемента успешно зависает. Обещание отклоняется, если нет ''selector'' соответствия элементов .

Этот метод выбирает элемент с помощью ''selector'' , при необходимости прокручивает его, а затем использует [[#pagemouse|page.mouse]] для наведения курсора на центр элемента. Если нет ''selector'' соответствия элемента , метод выдает ошибку.

==== frame.isDetached() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >

Возвращает ''true'' , если фрейм был отсоединен, или ''false'' в противном случае.

==== frame.name() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

Возвращает атрибут имени фрейма,как указано в теге.

Если имя пустое,возвращает атрибут id.

> **ПРИМЕЧАНИЕ.** Это значение рассчитывается один раз при создании кадра и не обновляется, если атрибут будет изменен позже. 

==== frame.parentFrame() ====

  * возвращает: <? [[#class-frame|Фрейм]] > Родительский фрейм, если есть. Отдельные фреймы и основные фреймы возвращают значение ''null'' .

==== кадр.выбор (селектор,...значения) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса кадра для
  * ''...values'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Значения параметров для выбора. Если ''<select>'' имеет атрибут ''multiple'' , учитываются все значения, в противном случае учитывается только первое.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >>> Массив значений параметров, которые были успешно выбраны.

Запускает событие ''change'' и ''input'' после выбора всех предоставленных параметров. Если нет ''selector'' соответствия элемента ''<select>'' , метод выдает ошибку.

<code javascript>
frame.select('select#colors', 'blue'); // одиночный выбор
frame.select('select#colors', 'red', 'green', 'blue'); // множественный выбор
</code>

==== frame.setContent(html[,options])) ====

  * ''html'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > HTML-разметка для назначения странице.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Параметры, которые могут иметь следующие свойства:
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время в миллисекундах для загрузки ресурсов, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaultnavigationtimeouttimeout|методов page.setDefaultNavigationTimeout (тайм-аут)]] или [[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout (тайм-аут)]] .
    * ''waitUntil'' <"load" | "domcontentloaded" | "networkidle0" | "networkidle2" | Array> Когда считать, что установка разметки прошла успешно, по умолчанию используется ''load'' . Учитывая массив строк событий, настройка содержимого считается успешной после того, как все события были запущены. События могут быть:
      * ''load'' - рассмотрите возможность завершения настройки содержимого при срабатывании события ''load'' .
      * ''domcontentloaded'' - рассмотрите возможность завершения настройки содержимого при ''DOMContentLoaded'' события DOMContentLoaded .
      * ''networkidle0'' - считайте, что настройка содержимого завершена, если не более 0 сетевых подключений в течение не менее ''500'' мс.
      * ''networkidle2'' - считайте, что настройка содержимого завершена, если не более 2 сетевых подключений в течение не менее ''500'' мс.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

==== frame.tap(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для поиска элемента, который нужно нажать. Если есть несколько элементов, удовлетворяющих селектору, будет выбран первый.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Этот метод выбирает элемент с помощью ''selector'' , при необходимости прокручивает его, а затем использует [[#pagetouchscreen|page.touchscreen]] для нажатия в центре элемента. Если нет ''selector'' соответствия элемента , метод выдает ошибку.

==== frame.title() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Заголовок страницы.

==== frame.type(селектор,text[,options])) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] элемента для ввода. Если есть несколько элементов, удовлетворяющих селектору, будет использован первый.
  * ''text'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Текст для ввода в выбранный элемент.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Время ожидания между нажатиями клавиш в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Посылает ''keydown'' , ''keypress'' / ''input'' и ''keyup'' событие для каждого символа в тексте.

Чтобы нажать специальную клавишу, например ''Control'' или ''ArrowDown'' , используйте ''[[#keyboardpresskey-options|keyboard.press]]'' .

<code javascript>
await frame.type('#mytextarea', 'Hello'); // Мгновенно набирает
await frame.type('#mytextarea', 'World', {delay: 100}); // Набирает медленнее, как пользователь
</code>

==== frame.url() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

Возвращает урну рамы.

==== frame.waitFor(selectorOrFunctionOrTimeout[,options[,...args]])). ====

  * ''selectorOrFunctionOrTimeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|номер]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] , предикат или тайм-аут для ожидания
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] >> Promise, которое преобразуется в JSHandle значения успеха

**Этот метод устарел** . Вам следует использовать более явные доступные методы API:

  * ''frame.waitForSelector''
  * ''frame.waitForXPath''
  * ''frame.waitForFunction''
  * ''frame.waitForTimeout''

Этот метод ведет себя по-разному по отношению к типу первого параметра:

  * если ''selectorOrFunctionOrTimeout'' является ''string'' , то первый аргумент обрабатывается как [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|селектор]] или [[https://developer.mozilla.org/en-US/docs/Web/XPath|xpath]] , в зависимости от того, начинается он с %%'//'%% или нет, а метод является ярлыком для [[#framewaitforselectorselector-options|frame.waitForSelector]] или [[#framewaitforxpathxpath-options|frame.waitForXPath]]
  * если ''selectorOrFunctionOrTimeout'' - это ''function'' , то первый аргумент рассматривается как [[#framewaitforfunctionpagefunction-options-args|ожидаемый]] предикат, а метод является ярлыком для frame.waitForFunction () .
  * если ''selectorOrFunctionOrTimeout'' - это ''number'' , то первый аргумент обрабатывается как тайм-аут в миллисекундах, и метод возвращает обещание, которое разрешается по истечении тайм-аута.
  * в противном случае делается исключение

<code javascript>
// ждем селектора
await page.waitFor('.foo');
// ждем 1 секунду
await page.waitFor(1000);
// ждем предиката
await page.waitFor(() => !!document.querySelector('.foo'));
</code>

Чтобы передать аргументы из node.js в предикат функции ''page.waitFor'' :

<code javascript>
const selector = '.foo';
await page.waitFor(selector => !!document.querySelector(selector), {}, selector);
</code>

==== frame.waitForFunction(pageFunction[,options[,...args]])). ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция для оценки в контексте браузера
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
    * ''polling'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Интервал, с которым выполняется ''pageFunction'' , по умолчанию ''raf'' . Если ''polling'' является числом, то он рассматривается как интервал в миллисекундах, с которым функция будет выполняться. Если ''polling'' представляет собой строку, это может быть одно из следующих значений:
      * ''raf'' - постоянно выполнять ''pageFunction'' в обратном вызове ''requestAnimationFrame'' . Это самый жесткий режим опроса, который подходит для наблюдения за изменениями стиля.
      * ''mutation'' - для выполнения ''pageFunction'' при каждой мутации DOM.
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > максимальное время ожидания в миллисекундах. По умолчанию ''30000'' (30 секунд). Передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] >> Promise, которое разрешается, когда ''pageFunction'' возвращает истинное значение. Он разрешает JSHandle истинного значения.

Функция ''waitForFunction'' может использоваться для наблюдения за изменением размера области просмотра:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  const watchDog = page.mainFrame().waitForFunction('window.innerWidth < 100');
  page.setViewport({width: 50, height: 50});
  await watchDog;
  await browser.close();
})();
</code>

Чтобы передать аргументы из node.js в предикат функции ''page.waitForFunction'' :

<code javascript>
const selector = '.foo';
await page.waitForFunction(selector => !!document.querySelector(selector), {}, selector);
</code>

==== frame.waitForNavigation%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Параметры навигации, которые могут иметь следующие свойства:
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Максимальное время навигации в миллисекундах, по умолчанию 30 секунд, передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaultnavigationtimeouttimeout|методов page.setDefaultNavigationTimeout (тайм-аут)]] или [[#pagesetdefaulttimeouttimeout|page.setDefaultTimeout (тайм-аут)]] .
    * ''waitUntil'' <"load" | "domcontentloaded" | "networkidle0" | "networkidle2" | Array> Если считать, что навигация прошла успешно, по умолчанию используется ''load'' . Учитывая массив строк событий, навигация считается успешной после того, как все события были запущены. События могут быть:
      * ''load'' - считайте, что навигация завершена, когда запускается событие ''load'' .
      * ''domcontentloaded'' - считается, что навигация завершена, когда ''DOMContentLoaded'' событие DOMContentLoaded .
      * ''networkidle0'' - считать, что навигация завершена, если не более 0 сетевых подключений в течение не менее ''500'' мс.
      * ''networkidle2'' - считайте, что навигация завершена, если не более 2 сетевых подключений в течение не менее ''500'' мс.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-httpresponse|HTTPResponse]] >> Promise, которое разрешается в ответ основного ресурса. В случае нескольких перенаправлений навигация разрешится с ответом последнего перенаправления. В случае перехода к другой привязке или навигации из-за использования History API, переход будет разрешен с помощью ''null'' .

Это разрешается,когда кадр переходит на новый URL.Это полезно,когда вы запускаете код,который косвенно вызывает навигацию фрейма.Рассмотрим этот пример:

<code javascript>
const [response] = await Promise.all([
  frame.waitForNavigation(), // Обещание навигации разрешается после завершения навигации
  frame.click('a.my-link'), // Нажатие на ссылку косвенно вызовет навигацию
]);
</code>

**ПРИМЕЧАНИЕ.** Использование [[https://developer.mozilla.org/en-US/docs/Web/API/History_API|History API]] для изменения URL-адреса считается навигацией.

==== frame.waitForSelector(селектор[,опции]). ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] элемента для ожидания
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
    * ''visible'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > ожидает, пока элемент будет присутствовать в DOM и станет видимым, то есть не будет иметь свойств CSS ''display: none'' или ''visibility: hidden'' . По умолчанию - ''false'' .
    * ''hidden'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > подождите, пока элемент не будет найден в DOM или будет скрыт, т.е. будет иметь свойства CSS ''display: none'' или ''visibility: hidden'' . По умолчанию - ''false'' .
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > максимальное время ожидания в миллисекундах. По умолчанию ''30000'' (30 секунд). Передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-elementhandle|ElementHandle]] >> Promise, которое разрешается, когда элемент, указанный в строке селектора, добавляется в DOM. Преобразуется в ''null'' , если ожидание ''hidden: true'' и селектор не найден в DOM.

Подождите, пока на странице появится ''selector'' . Если на момент вызова метода ''selector'' уже существует, метод немедленно вернется. Если селектор не появляется после истечения времени ''timeout'' миллисекундах, функция сгенерирует.

Этот метод работает во всех навигациях:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  let currentURL;
  page.mainFrame()
    .waitForSelector('img')
    .then(() => console.log('First URL with image: ' + currentURL));
  for (currentURL of ['https://example.com', 'https://google.com', 'https://bbc.com']) {
    await page.goto(currentURL);
  }
  await browser.close();
})();
</code>

==== frame.waitForTimeout(milliseconds) ====

  * ''milliseconds'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Количество миллисекунд ожидания.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается по истечении тайм-аута.

Приостанавливает выполнение сценария на заданное количество секунд перед продолжением:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  page.mainFrame()
    .waitForTimeout(1000)
    .then(() => console.log('Waited a second!'));

  await browser.close();
})();
</code>

==== frame.waitForXPath(xpath[,опции]). ====

  * ''xpath'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/XPath|xpath]] элемента для ожидания
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры ожидания
    * ''visible'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > ожидает, пока элемент будет присутствовать в DOM и станет видимым, то есть не будет иметь свойств CSS ''display: none'' или ''visibility: hidden'' . По умолчанию - ''false'' .
    * ''hidden'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > подождите, пока элемент не будет найден в DOM или будет скрыт, т.е. будет иметь свойства CSS ''display: none'' или ''visibility: hidden'' . По умолчанию - ''false'' .
    * ''timeout'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > максимальное время ожидания в миллисекундах. По умолчанию ''30000'' (30 секунд). Передайте ''0'' , чтобы отключить тайм-аут. Значение по умолчанию можно изменить с помощью [[#pagesetdefaulttimeouttimeout|метода page.setDefaultTimeout (timeout)]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-elementhandle|ElementHandle]] >> Promise, которое разрешается, когда элемент, указанный в строке xpath, добавляется в DOM. Преобразуется в ''null'' , если ожидает ''hidden: true'' и xpath не найден в DOM.

Подождите, пока ''xpath'' не появится на странице. Если на момент вызова метода ''xpath'' уже существует, метод немедленно вернется. Если xpath не появляется после истечения времени ''timeout'' миллисекундах, функция сгенерирует.

Этот метод работает во всех навигациях:

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  let currentURL;
  page.mainFrame()
    .waitForXPath('//img')
    .then(() => console.log('First URL with image: ' + currentURL));
  for (currentURL of ['https://example.com', 'https://google.com', 'https://bbc.com']) {
    await page.goto(currentURL);
  }
  await browser.close();
})();
</code>

===== Класс:ExecutionContext =====

Класс представляет собой контекст для выполнения JavaScript. [[#class-page|Страница]] может иметь много контекстов исполнения:

  * каждый [[https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe|фрейм]] имеет контекст выполнения «по умолчанию», который всегда создается после того, как фрейм прикреплен к DOM. Этот контекст возвращается методом ''[[#frameexecutioncontext|frame.executionContext()]]'' .
  * Скрипты содержимого расширений создают дополнительные контексты выполнения.

Помимо страниц, контексты выполнения можно найти в [[https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API|worker-ах]] .

==== executionContext.assess(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция, которая будет оцениваться при ''executionContext''
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Если функция, переданная в ''executionContext.evaluate'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , то ''executionContext.evaluate'' будет ждать разрешения обещания и вернуть свое значение.

Если функция, переданная в ''executionContext.evaluate'' , возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|несериализуемое]] значение, то ''executionContext.evaluate'' принимает значение ''undefined'' . Протокол DevTools также поддерживает передачу некоторых дополнительных значений, не сериализуемых с помощью ''JSON'' : ''-0'' , ''NaN'' , ''Infinity'' , ''-Infinity'' и литералы bigint.

<code javascript>
const executionContext = await page.mainFrame().executionContext();
const result = await executionContext.evaluate(() => Promise.resolve(8 * 7));
console.log(result); // prints "56"
</code>

Также вместо функции может быть передана строка.

<code javascript>
console.log(await executionContext.evaluate('1 + 2')); // prints "3"
</code>

[[#class-jshandle|JSHandle]] экземпляры могут быть переданы в качестве аргументов ''executionContext.evaluate'' :

<code javascript>
const oneHandle = await executionContext.evaluateHandle(() => 1);
const twoHandle = await executionContext.evaluateHandle(() => 2);
const result = await executionContext.evaluate((a, b) => a + b, oneHandle, twoHandle);
await oneHandle.dispose();
await twoHandle.dispose();
console.log(result); // prints '3'.
</code>

==== executionContext.assessHandle(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция для оценки в ''executionContext''
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] | [[#class-elementhandle|ElementHandle]] >> Promise, которое ''pageFunction'' в возвращаемое значение pageFunction как внутристраничный объект.

Единственное различие между ''executionContext.evaluate'' и ''executionContext.evaluateHandle'' является то , что ''executionContext.evaluateHandle'' возвращается в-странице объекта (JSHandle).

Если функция возвращает элемент, возвращаемый дескриптор - [[#class-elementhandle|ElementHandle]] .

Если функция, переданная в ''executionContext.evaluateHandle'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , то ''executionContext.evaluateHandle'' будет ждать разрешения обещания и вернет свое значение.

<code javascript>
const context = await page.mainFrame().executionContext();
const aHandle = await context.evaluateHandle(() => Promise.resolve(self));
aHandle; // Дескриптор глобального объекта.
</code>

Также вместо функции может быть передана строка.

<code javascript>
const aHandle = await context.evaluateHandle('1 + 2'); // Дескриптор объекта "3".
</code>

[[#class-jshandle|JSHandle]] экземпляры могут быть переданы в качестве аргументов ''executionContext.evaluateHandle'' :

<code javascript>
const aHandle = await context.evaluateHandle(() => document.body);
const resultHandle = await context.evaluateHandle(body => body.innerHTML, aHandle);
console.log(await resultHandle.jsonValue()); // выводит внутренний HTML-код тела
await aHandle.dispose();
await resultHandle.dispose();
</code>

==== executionContext.frame() ====

  * возвращает: <? [[#class-frame|Кадр]] > Кадр, связанный с этим контекстом выполнения.

> **ПРИМЕЧАНИЕ.** Не каждый контекст выполнения связан с фреймом. Например, рабочие процессы и расширения имеют контексты выполнения, не связанные с фреймами. 

==== executionContext.queryObjects(prototypeHandle) ====

  * ''prototypeHandle'' < [[#class-jshandle|JSHandle]] > Дескриптор прототипа объекта.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] >> Дескриптор массива объектов с этим прототипом

Метод итерирует кучу JavaScript и находит все объекты с данным прототипом.

<code javascript>
// Создаем объект Map
await page.evaluate(() => window.map = new Map());
// Получаем дескриптор прототипа объекта Map
const mapPrototype = await page.evaluateHandle(() => Map.prototype);
// Запрос всех экземпляров карты в массив
const mapInstances = await page.queryObjects(mapPrototype);
// Подсчитываем количество объектов карты в куче
const count = await page.evaluate(maps => maps.length, mapInstances);
await mapInstances.dispose();
await mapPrototype.dispose();
</code>

===== Класс:JSHandle =====

JSHandle представляет собой объект JavaScript на странице. JSHandles можно создать с [[#pageevaluatehandlepagefunction-args|помощью]] метода page.evaluateHandle .

<code javascript>
const windowHandle = await page.evaluateHandle(() => window);
// ...
</code>

JSHandle предотвращает сборку мусора для указанного объекта JavaScript, если дескриптор не [[#jshandledispose|удален]] . JSHandles автоматически удаляются при переходе по их исходному фрейму или при уничтожении родительского контекста.

Экземпляры JSHandle могут использоваться в качестве аргументов в методах ''[[#pageevalselector-pagefunction-args|page.$eval()]]'' , ''[[#pageevaluatepagefunction-args|page.evaluate()]]'' и ''[[#pageevaluatehandlepagefunction-args|page.evaluateHandle]]'' .

==== jsHandle.asElement() ====

  * возвращает: <? [[#class-elementhandle|ElementHandle]] >

Возвращает либо ''null'' , либо сам дескриптор объекта, если дескриптор объекта является экземпляром [[#class-elementhandle|ElementHandle]] .

==== jsHandle.dispose() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается после успешного удаления дескриптора объекта.

Метод ''jsHandle.dispose'' перестает ссылаться на дескриптор элемента.

==== jsHandle.assess(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] )> Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Этот метод передает этот дескриптор в качестве первого аргумента функции ''pageFunction'' .

Если ''pageFunction'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|обещание]] , то ''handle.evaluate'' будет ждать разрешения обещания и вернет его значение.

Examples:

<code javascript>
const tweetHandle = await page.$('.tweet .retweets');
expect(await tweetHandle.evaluate(node => node.innerText)).toBe('10');
</code>

==== jsHandle.assessHandle(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция для оценки
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] | [[#class-elementhandle|ElementHandle]] >> Promise, которое ''pageFunction'' в возвращаемое значение pageFunction как внутристраничный объект.

Этот метод передает этот дескриптор в качестве первого аргумента функции ''pageFunction'' .

Единственное различие между ''jsHandle.evaluate'' и ''jsHandle.evaluateHandle'' является то , что ''executionContext.evaluateHandle'' возвращается в-странице объекта (JSHandle).

Если функция возвращает элемент, возвращаемый дескриптор - [[#class-elementhandle|ElementHandle]] .

Если функция, переданная в ''jsHandle.evaluateHandle'' , возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , тогда ''jsHandle.evaluateHandle'' будет ждать разрешения обещания и вернет свое значение.

См. [[#pageevaluatehandlepagefunction-args|Page.evaluateHandle]] для более подробной информации.

==== jsHandle.executionContext() ====

  * возвращает: < [[#class-executioncontext|ExecutionContext]] >

Возвращает контекст выполнения,к которому принадлежит дескриптор.

==== jsHandle.getProperties() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map|Map]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] , [[#class-jshandle|JSHandle]] >>>

Метод возвращает карту с именами свойств в качестве ключей и экземплярами JSHandle для значений свойств.

<code javascript>
const handle = await page.evaluateHandle(() => ({window, document}));
const properties = await handle.getProperties();
const windowHandle = properties.get('window');
const documentHandle = properties.get('document');
await handle.dispose();
</code>

==== jsHandle.getProperty(propertyName) ====

  * ''propertyName'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > свойство для получения
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] >>

Получает единственное свойство от объекта,на который делается ссылка.

==== jsHandle.jsonValue() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >>

Возвращает JSON-представление объекта. Если у объекта есть функция ''[[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#toJSON()_behavior|toJSON]]'' , он **не будет вызываться** .

> **ПРИМЕЧАНИЕ** . Метод вернет пустой объект JSON, если объект, на который указывает ссылка, не является строковым. Это вызовет ошибку, если объект имеет циклические ссылки. 

===== Класс:ElementHandle =====

  * расширяется: [[#class-jshandle|JSHandle]]

ElementHandle представляет собой элемент DOM на странице. ElementHandles можно создать с помощью метода [[#pageselector|page. $]] .

<code javascript>
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  const hrefElement = await page.$('a');
  await hrefElement.click();
  // ...
})();
</code>

ElementHandle предотвращает сборку мусора для элемента DOM, если дескриптор не [[#elementhandledispose|удален]] . ElementHandles автоматически удаляются при переходе по их исходному фрейму.

Экземпляры ElementHandle могут использоваться в качестве аргументов в методах ''[[#pageevalselector-pagefunction-args|page.$eval()]]'' и ''[[#pageevaluatepagefunction-args|page.evaluate()]]'' .

==== elementHandle.$(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса элемента для
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-elementhandle|ElementHandle]] >>

Метод запускает ''element.querySelector'' на странице. Если ни один элемент не соответствует селектору, возвращаемое значение принимает значение ''null'' .

==== elementHandle.$$(selector) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса элемента для
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-elementhandle|ElementHandle]] >>>

Метод запускает ''element.querySelectorAll'' на странице. Если ни один элемент не соответствует селектору, возвращаемое значение преобразуется в ''[]'' .

==== elementHandle.$$eval(селектор,функция pageFunction[,...args])) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса страницы для
  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/API/element|Element]] >)> Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Этот метод запускает ''document.querySelectorAll'' внутри элемента и передает его в качестве первого аргумента в ''pageFunction'' . Если нет ''selector'' соответствия элемента , метод выдает ошибку.

Если ''pageFunction'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , то ''frame.$$eval'' будет ждать разрешения обещания и вернет его значение.

Examples:

<code javascript>
<div class="feed">
  <div class="tweet">Hello!</div>
  <div class="tweet">Hi!</div>
</div>
</code>

<code javascript>
const feedHandle = await page.$('.feed');
expect(await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText))).toEqual(['Hello!', 'Hi!']);
</code>

==== elementHandle.$eval(селектор,pageFunction[,...args])) ====

  * ''selector'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > [[https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors|Селектор]] для запроса страницы для
  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[https://developer.mozilla.org/en-US/docs/Web/API/element|Element]] )> Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Этот метод запускает ''document.querySelector'' внутри элемента и передает его в качестве первого аргумента ''pageFunction'' . Если нет ''selector'' соответствия элемента , метод выдает ошибку.

Если ''pageFunction'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|обещание]] , то ''frame.$eval'' будет ждать разрешения обещания и вернет его значение.

Examples:

<code javascript>
const tweetHandle = await page.$('.tweet');
expect(await tweetHandle.$eval('.like', node => node.innerText)).toBe('100');
expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10');
</code>

==== elementHandle.$x(expression) ====

  * ''expression'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Выражение для [[https://developer.mozilla.org/en-US/docs/Web/API/Document/evaluate|оценки]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[#class-elementhandle|ElementHandle]] >>>

Метод оценивает выражение XPath относительно ''elementHandle'' как его контекстного узла. Если таких элементов нет, метод преобразуется в пустой массив.

''expression'' должно иметь узел контекста , чтобы оценить должным образом:

<code javascript>
const [childHandle] = await parentHandle.$x('./div');
</code>

==== elementHandle.asElement() ====

  * возвращает: < [[#class-elementhandle|ElementHandle]] >

==== elementHandle.boundingBox() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >>
    * x < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > координата x элемента в пикселях.
    * y < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > координата y элемента в пикселях.
    * width < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > ширина элемента в пикселях.
    * height < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > высота элемента в пикселях.

Этот метод возвращает ограничивающую рамку элемента (относительно основного фрейма) или значение ''null'' , если элемент не отображается.

==== elementHandle.boxModel() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >>
    * content < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Поле содержимого.
      * x < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
      * y < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
    * padding < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Padding box.
      * x < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
      * y < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
    * border < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Border box.
      * x < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
      * y < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
    * margin < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Поле поля.
      * x < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
      * y < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >
    * width < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Ширина элемента.
    * height < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Высота элемента.

Этот метод возвращает поля элемента или ''null'' , если элемент не отображается. Ящики представлены в виде массива точек; каждая точка - это объект ''{x, y}'' . Пункты бокса отсортированы по часовой стрелке.

==== elementHandle.click%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''button'' <"left" | "right" | "middle"> По умолчанию ''left'' .
    * ''clickCount'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > по умолчанию [[https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail|равен]] 1. См. UIEvent.detail .
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Время ожидания между ''mousedown'' и ''mouseup'' в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается при успешном нажатии на элемент. Promise отклоняется, если элемент отсоединяется от DOM.

Этот метод при необходимости прокручивает элемент в поле зрения, а затем с помощью [[#pagemouse|page.mouse]] щелкает в центре элемента. Если элемент отсоединен от DOM, метод выдает ошибку.

==== elementHandle.contentFrame() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-frame|Frame]] >> Преобразует фрейм содержимого для дескрипторов элементов, ссылающихся на узлы iframe, или null в противном случае

==== elementHandle.dispose() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается после успешного удаления дескриптора элемента.

Метод ''elementHandle.dispose'' перестает ссылаться на дескриптор элемента.

==== elementHandle.assess(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|function]] ( [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] )> Функция для оценки в контексте браузера
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Serializable]] >> Promise, которое разрешается в возвращаемое значение ''pageFunction''

Этот метод передает этот дескриптор в качестве первого аргумента функции ''pageFunction'' .

Если ''pageFunction'' возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|обещание]] , то ''handle.evaluate'' будет ждать разрешения обещания и вернет его значение.

Examples:

<code javascript>
const tweetHandle = await page.$('.tweet .retweets');
expect(await tweetHandle.evaluate(node => node.innerText)).toBe('10');
</code>

==== elementHandle.assessHandle(pageFunction[,...args])) ====

  * ''pageFunction'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|функция]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Функция для оценки
  * ''...args'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Сериализуемый]] | [[#class-jshandle|JSHandle]] > Аргументы для передачи на ''pageFunction''
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] | [[#class-elementhandle|ElementHandle]] >> Promise, которое ''pageFunction'' в возвращаемое значение pageFunction как внутристраничный объект.

Этот метод передает этот дескриптор в качестве первого аргумента функции ''pageFunction'' .

Единственное различие между ''elementHandle.evaluate'' и ''elementHandle.evaluateHandle'' является то , что ''executionContext.evaluateHandle'' возвращается в-странице объекта (JSHandle).

Если функция возвращает элемент, возвращаемый дескриптор - [[#class-elementhandle|ElementHandle]] .

Если функция, переданная в ''elementHandle.evaluateHandle'' , возвращает [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] , тогда ''elementHandle.evaluateHandle'' будет ждать разрешения обещания и вернет его значение.

См. [[#pageevaluatehandlepagefunction-args|Page.evaluateHandle]] для более подробной информации.

==== elementHandle.executionContext() ====

  * возвращает: < [[#class-executioncontext|ExecutionContext]] >

==== elementHandle.focus() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Вызывает [[https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus|фокус]] на элементе.

==== elementHandle.getProperties() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map|Map]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] , [[#class-jshandle|JSHandle]] >>>

Метод возвращает карту с именами свойств в качестве ключей и экземплярами JSHandle для значений свойств.

<code javascript>
const listHandle = await page.evaluateHandle(() => document.body.children);
const properties = await listHandle.getProperties();
const children = [];
for (const property of properties.values()) {
  const element = property.asElement();
  if (element)
    children.push(element);
}
children; // содержит elementHandles для всех дочерних элементов document.body
</code>

==== elementHandle.getProperty(propertyName) ====

  * ''propertyName'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > свойство для получения
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-jshandle|JSHandle]] >>

Получает единственное свойство от objectHandle.

==== elementHandle.hover() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается, когда элемент успешно зависает.

Этот метод при необходимости прокручивает элемент в поле зрения, а затем использует [[#pagemouse|page.mouse]] для наведения курсора на центр элемента. Если элемент отсоединен от DOM, метод выдает ошибку.

==== elementHandle.isIntersectingViewport() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] >> Принимает значение true, если элемент виден в текущем окне просмотра.

==== elementHandle.jsonValue() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >>

Возвращает JSON-представление объекта. JSON создается путем запуска ''[[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify|JSON.stringify]]'' для объекта на странице и последующего ''[[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse|JSON.parse]]'' в puppeteer.

> **ПРИМЕЧАНИЕ** . Метод будет выдан, если объект, на который указывает ссылка, не является строковым. 

==== elementHandle.press(key[,options])) ====

  * ''key'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Имя клавиши, которую нужно нажать, например ''ArrowLeft'' . См. Список всех имен клавиш в [[https://github.com/puppeteer/puppeteer/blob/v7.1.0/src/common/USKeyboardLayout.ts|USKeyboardLayout]] .
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''text'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Если указано, генерирует событие ввода с этим текстом.
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Время ожидания между ''keydown'' и ''keyup'' в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Фокусирует элемент, а затем использует ''[[#keyboarddownkey-options|keyboard.down]]'' и ''[[#keyboardupkey|keyboard.up]]'' .

Если ''key'' состоит из одного символа и не удерживаются никакие клавиши-модификаторы, кроме ''Shift'' , также будет сгенерировано событие ''keypress'' / ''input'' . ''text'' опция может быть указана , чтобы заставить событие ввода , который будет создан.

> **ПРИМЕЧАНИЕ.** Клавиши-модификаторы ''elementHandle.press'' влияют на elementHandle.press . Удерживая нажатой ''Shift'' вы набираете текст в верхнем регистре. 

==== elementHandle.screenshot%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Те же параметры, что и в [[#pagescreenshotoptions|page.screenshot]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] | [[https://nodejs.org/api/buffer.html#buffer_class_buffer|Buffer]] >> Promise, который разрешается в буфер или строку base64 (в зависимости от значения ''options.encoding'' ) с захваченным снимком экрана.

Этот метод прокручивает элемент в поле зрения, если необходимо, а затем использует [[#pagescreenshotoptions|page.screenshot]] для создания снимка экрана элемента. Если элемент отсоединен от DOM, метод выдает ошибку.

==== elementHandle.select(...values) ====

  * ''...values'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Значения параметров для выбора. Если ''<select>'' имеет атрибут ''multiple'' , учитываются все значения, в противном случае учитывается только первое.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >>> Массив значений параметров, которые были успешно выбраны.

Запускает событие ''change'' и ''input'' после выбора всех предоставленных параметров. Если нет ''selector'' соответствия элемента ''<select>'' , метод выдает ошибку.

<code javascript>
handle.select('blue'); // одиночный выбор
handle.select('red', 'green', 'blue'); // множественный выбор
</code>

==== elementHandle.tap() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Promise, которое разрешается при успешном нажатии на элемент. Promise отклоняется, если элемент отсоединяется от DOM.

Этот метод при необходимости прокручивает элемент в поле зрения, а затем использует [[#touchscreentapx-y|touchscreen.tap]] для нажатия в центре элемента. Если элемент отсоединен от DOM, метод выдает ошибку.

==== elementHandle.toString() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

==== elementHandle.type(text[,options])) ====

  * ''text'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Текст для ввода в выбранный элемент.
  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >
    * ''delay'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Время ожидания между нажатиями клавиш в миллисекундах. По умолчанию 0.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Фокусирует элемент, а затем отправляет события ''keydown'' , ''keypress'' / ''input'' и ''keyup'' для каждого символа в тексте.

Чтобы нажать специальную клавишу, например ''Control'' или ''ArrowDown'' , используйте ''[[#elementhandlepresskey-options|elementHandle.press]]'' .

<code javascript>
await elementHandle.type('Hello'); // Мгновенно набирает
await elementHandle.type('World', {delay: 100}); // Набирает медленнее, как пользователь
</code>

Пример ввода в текстовое поле и последующей отправки формы:

<code javascript>
const elementHandle = await page.$('input');
await elementHandle.type('some text');
await elementHandle.press('Enter');
</code>

==== elementHandle.uploadFile(...filePaths) ====

  * ''...filePaths'' <... [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Устанавливает значение входного файла для этих путей. Если некоторые из ''filePaths'' путей являются относительными путями, они разрешаются относительно [[https://nodejs.org/api/process.html#process_process_cwd|текущего рабочего каталога]] .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Этот метод ожидает, что ''elementHandle'' укажет на [[https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input|элемент ввода]] .

===== class: HTTPRequest =====

Всякий раз,когда страница посылает запрос,например,на сетевой ресурс,страничка кукловода испускает следующие события:

  * ''[[#event-request|'request']]'' генерируется, когда запрос выдается страницей.
  * ''[[#event-response|'response']]'' генерируется, когда / если на запрос получен ответ.
  * ''[[#event-requestfinished|'requestfinished']]'' когда тело ответа загружено и запрос завершен.

Если в какой-то момент запрос не выполняется, то вместо события '''requestfinished''' (и, возможно, вместо события response) ''[[#event-requestfailed|'requestfailed']]'' событие requestfailed .

> **ПРИМЕЧАНИЕ.** Ответы HTTP Error, такие как 404 или 503, по-прежнему являются успешными ответами с точки зрения HTTP, поэтому запрос завершится с событием '''requestfinished''' . 

Если на запрос получен ответ 'redirect',то запрос успешно завершается событием 'requestfinished',и новый запрос выдается на перенаправленный url.

==== httpRequest.abort%%([%%errorCode]) ====

  * ''errorCode'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Необязательный код ошибки. По умолчанию ''failed'' , может быть одно из следующих:
    * ''aborted'' - операция была прервана (из-за действия пользователя)
    * ''accessdenied'' - В разрешении на доступ к ресурсу, кроме сети, было отказано
    * ''addressunreachable'' - IP-адрес недоступен. Обычно это означает, что нет маршрута к указанному хосту или сети.
    * ''blockedbyclient'' - клиент решил заблокировать запрос.
    * ''blockedbyresponse'' - запрос завершился неудачно, поскольку ответ был доставлен вместе с невыполненными требованиями (например, проверки предков «X-Frame-Options» и «Content-Security-Policy»).
    * ''connectionaborted'' - время ожидания соединения истекло из-за неполучения ACK для отправленных данных.
    * ''connectionclosed'' - соединение было закрыто (соответствует TCP FIN).
    * ''connectionfailed'' - попытка подключения не удалась.
    * ''connectionrefused'' - попытка подключения отклонена.
    * ''connectionreset'' - соединение было сброшено (соответствует TCP RST).
    * ''internetdisconnected'' - Интернет-соединение потеряно.
    * ''namenotresolved'' - имя хоста не может быть разрешено.
    * ''timedout'' - время ожидания операции истекло.
    * ''failed'' - произошел общий сбой.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отменяет запрос. Чтобы использовать это, перехват запроса должен быть включен с помощью ''page.setRequestInterception'' . Если перехват запроса не включен, немедленно генерируется исключение.

==== httpRequest.continue%%([%%overrides]) ====

  * ''overrides'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные перезаписи запроса, которые могут быть одним из следующих:
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Если установлено, URL запроса будет изменен. Это не перенаправление. Запрос будет автоматически перенаправлен на новый URL. Например, в адресной строке будет отображаться исходный URL-адрес.
    * ''method'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Если установлено, изменяет метод запроса (например, ''GET'' или ''POST'' )
    * ''postData'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Если установлено, изменяет данные сообщения запроса
    * ''headers'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Если установлено, изменяет заголовки HTTP запроса. Значения заголовка будут преобразованы в строку.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Продолжает запрос с необязательными переопределениями запроса. Чтобы использовать это, перехват запроса должен быть включен с помощью ''page.setRequestInterception'' . Если перехват запроса не включен, немедленно генерируется исключение.

<code javascript>
await page.setRequestInterception(true);
page.on('request', request => {
  // Переопределить заголовки
  const headers = Object.assign({}, request.headers(), {
    foo: 'bar', // устанавливаем заголовок "foo"
    origin: undefined, // удаляем заголовок "origin"
  });
  request.continue({headers});
});
</code>

==== httpRequest.failure() ====

  * возвращает: <? [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] > Объект, описывающий сбой запроса, если есть
    * ''errorText'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Сообщение об ошибке, '''net::ERR_FAILED''' человеку, например , net :: ERR_FAILED .

Метод возвращает значение ''null'' , если этот запрос не был неудачным, о чем сообщает событие ''requestfailed'' .

Пример протоколирования всех неудачных запросов:

<code javascript>
page.on('requestfailed', request => {
  console.log(request.url() + ' ' + request.failure().errorText);
});
</code>

==== httpRequest.frame() ====

  * возвращает: <? [[#class-frame|Кадр]] > [[#class-frame|Кадр]] , инициировавший этот запрос, или ''null'' при переходе на страницы ошибок.

==== httpRequest.headers() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Объект с заголовками HTTP, связанными с запросом. Все имена заголовков в нижнем регистре.

==== httpRequest.isNavigationRequest() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >

Является ли этот запрос навигацией водительской рамы.

==== httpRequest.method() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Метод запроса (GET, POST и т. д.)

==== httpRequest.postData() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Тело сообщения запроса, если оно есть.

==== httpRequest.redirectChain() ====

  * returns: <[[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]]<[[#class-httprequest|HTTPRequest]]>>

''redirectChain'' представляет собой цепочку запросов , инициированных извлечь ресурс.

  * Если нет переадресации и запрос был успешным,цепь будет пустой.
  * Если сервер отвечает хотя бы одним перенаправлением,то цепочка будет содержать все запросы,которые были перенаправлены.

''redirectChain'' используется всеми запросами одной цепочки.

Например, если на сайте ''http://example.com'' есть один редирект на ''https://example.com'' , то цепочка будет содержать один запрос:

<code javascript>
const response = await page.goto('http://example.com');
const chain = response.request().redirectChain();
console.log(chain.length); // 1
console.log(chain[0].url()); // 'http://example.com'
</code>

Если на сайте ''https://google.com'' нет редиректов, то цепочка будет пустой:

<code javascript>
const response = await page.goto('https://google.com');
const chain = response.request().redirectChain();
console.log(chain.length); // 0
</code>

==== httpRequest.resourceType() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

Содержит тип ресурса запроса, как он был воспринят механизмом визуализации. ResourceType будет одним из следующих: ''document'' , ''stylesheet'' , ''image'' , ''media'' , ''font'' , ''script'' , ''texttrack'' , ''xhr'' , ''fetch'' , источник ''eventsource'' , ''websocket'' , ''manifest'' , ''other'' .

==== httpRequest.respond(response) ====

  * ''response'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Ответ, который выполнит этот запрос
    * ''status'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Код состояния ответа, по умолчанию ''200'' .
    * ''headers'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные заголовки ответа. Значения заголовка будут преобразованы в строку.
    * ''contentType'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Если установлено, равно установке заголовка ответа ''Content-Type''
    * ''body'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://nodejs.org/api/buffer.html#buffer_class_buffer|Буфер]] > Необязательное тело ответа
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Выполняет запрос с заданным ответом. Чтобы использовать это, перехват запроса должен быть включен с помощью ''page.setRequestInterception'' . Исключение генерируется, если перехват запроса не включен.

Пример выполнения всех запросов с 404 ответами:

<code javascript>
await page.setRequestInterception(true);
page.on('request', request => {
  request.respond({
    status: 404,
    contentType: 'text/plain',
    body: 'Not Found!'
  });
});
</code>

> **ПРИМЕЧАНИЕ.** Мокирующие ответы на запросы dataURL не поддерживаются. Вызов ''request.respond'' для запроса dataURL - это пусто. 

==== httpRequest.response() ====

  * возвращает: <? [[#class-httpresponse|HTTPResponse]] > [[#class-httpresponse|Соответствующий]] объект HTTPResponse или ''null'' , если ответ еще не получен.

==== httpRequest.url() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > URL запроса.

===== class: HTTPResponse =====

Класс HTTPResponse представляет ответы, полученные страницей.

==== httpResponse.buffer() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://nodejs.org/api/buffer.html#buffer_class_buffer|Buffer]] >> Promise, которое преобразуется в буфер с телом ответа.

==== httpResponse.frame() ====

  * возвращает: <? [[#class-frame|Frame]] > [[#class-frame|Frame]] , инициировавший этот ответ, или ''null'' при переходе к страницам ошибок.

==== httpResponse.fromCache() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >

Правда,если ответ был подан либо из кэша диска браузера,либо из кэша памяти.

==== httpResponse.fromServiceWorker() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >

Верно,если ответ был получен от работника сервисной службы.

==== httpResponse.headers() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Объект с заголовками HTTP, связанными с ответом. Все имена заголовков в нижнем регистре.

==== httpResponse.json() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Promise, которое преобразуется в JSON-представление тела ответа.

Этот метод будет сгенерирован, если тело ответа не может быть ''JSON.parse'' через JSON.parse .

==== httpResponse.ok() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|логическое]] >

Содержит логическое указание на то,была ли реакция успешной (состояние в диапазоне 200-299)или нет.

==== httpResponse.remoteAddress() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >
    * ''ip'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > IP-адрес удаленного сервера
    * ''port'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|номер]] > порт, используемый для подключения к удаленному серверу

==== httpResponse.request() ====

  * возвращает: < [[#class-httprequest|HTTPRequest]] > [[#class-httprequest|Соответствующий]] объект HTTPRequest .

==== httpResponse.securityDetails() ====

  * возвращает: <? [[#class-securitydetails|SecurityDetails]] > Сведения о безопасности, если ответ был получен через защищенное соединение, или ''null'' в противном случае.

==== httpResponse.status() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] >

Содержит код статуса ответа (например,200 для успеха).

==== httpResponse.statusText() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

Содержит текст статуса ответа (например,обычно "ОК" для успеха).

==== httpResponse.text() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Promise, которое преобразуется в текстовое представление тела ответа.

==== httpResponse.url() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

Содержит URL ответа.

===== Класс:SecurityDetails =====

Класс SecurityDetails представляет сведения о безопасности при получении ответа по защищенному соединению.

==== securityDetails.issuer() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Строка с именем издателя сертификата.

==== securityDetails.protocol() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Строка с протоколом безопасности, например. «TLS 1.2».

==== securityDetails.subjectAlternativeNames() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] >> Возвращает список SAN (альтернативные имена субъектов) сертификата.

==== securityDetails.subjectName() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > Имя субъекта, которому был выдан сертификат.

==== securityDetails.validFrom() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > [[https://en.wikipedia.org/wiki/Unix_time|UnixTime, указывающее]] начало срока действия сертификата.

==== securityDetails.validTo() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > [[https://en.wikipedia.org/wiki/Unix_time|UnixTime,]] сообщающее об окончании срока действия сертификата.

===== Класс:Цель =====

==== target.browser() ====

  * возвращает: < [[#class-browser|Браузер]] >

Получите браузер,к которому принадлежит цель.

==== target.browserContext() ====

  * возвращает: < [[#class-browsercontext|BrowserContext]] >

Контекст браузера,к которому принадлежит цель.

==== target.createCDPSession() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[#class-cdpsession|CDPSession]] >>

Создает сеанс протокола Chrome Devtools,прикрепленный к цели.

==== target.opener() ====

  * возвращает: <? [[#class-target|Цель]] >

Получите цель, открывшую эту цель. Целевые объекты верхнего уровня возвращают значение ''null'' .

==== target.page() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] <? [[#class-page|Страница]] >>

Если цель не относится к типу ''"page"'' или ''"background_page"'' , возвращается значение ''null'' .

==== target.type() ====

  * возвращает: <"page" | "background_page" | "service_worker" | "shared_worker" | "other" | "browser">

Определяет, что это за цель. Может быть ''"page"'' , ''[[https://developer.chrome.com/extensions/background_pages|"background_page"]]'' , ''"service_worker"'' , ''"shared_worker"'' , ''"browser"'' или ''"other"'' .

==== target.url() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] >

==== target.worker() ====

  * returns: <[[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]]<?[[#class-webworker|WebWorker]]>>

Если цель не относится к типу ''"service_worker"'' или ''"shared_worker"'' , возвращается значение ''null'' .

===== Класс:CDPSession =====

  * extends: [[#class-eventemitter|EventEmitter]]

В ''CDPSession'' экземпляры привыкли говорить сырец Chrome DevTools протокол:

  * Методы протокола можно вызывать с помощью метода ''session.send'' .
  * на события протокола можно подписаться с помощью метода ''session.on'' .

Полезные ссылки:

  * Документацию по протоколу DevTools можно найти здесь: [[https://chromedevtools.github.io/devtools-protocol/|Средство просмотра протокола DevTools]] .
  * Начало работы с протоколом DevTools: [[https://github.com/aslushnikov/getting-started-with-cdp/blob/master/README.md|https://github.com/aslushnikov/getting-started-with-cdp/blob/master/README.md]]

<code javascript>
const client = await page.target().createCDPSession();
await client.send('Animation.enable');
client.on('Animation.animationCreated', () => console.log('Animation created!'));
const response = await client.send('Animation.getPlaybackRate');
console.log('playback rate is ' + response.playbackRate);
await client.send('Animation.setPlaybackRate', {
  playbackRate: response.playbackRate / 2
});
</code>

==== cdpSession.detach() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] >

Отсоединяет cdpSession от цели.После отсоединения объект cdpSession не будет испускать никаких событий и не может использоваться для отправки сообщений.

==== cdpSession.send(method[, ...paramArgs]) ====

  * ''method'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > имя метода протокола
  * ''...paramArgs'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Необязательные параметры метода
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Обещание]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >>

===== Класс:Покрытие =====

Coverage собирает информацию о тех частях JavaScript и CSS,которые использовались на странице.

Пример использования JavaScript и CSS-покрытия для получения процента первоначально выполненного кода:

<code javascript>
// Включение покрытия как JavaScript, так и CSS
await Promise.all([
  page.coverage.startJSCoverage(),
  page.coverage.startCSSCoverage()
]);
// Переходим на страницу
await page.goto('https://example.com');
// Отключить покрытие JavaScript и CSS
const [jsCoverage, cssCoverage] = await Promise.all([
  page.coverage.stopJSCoverage(),
  page.coverage.stopCSSCoverage(),
]);
let totalBytes = 0;
let usedBytes = 0;
const coverage = [...jsCoverage, ...cssCoverage];
for (const entry of coverage) {
  totalBytes += entry.text.length;
  for (const range of entry.ranges)
    usedBytes += range.end - range.start - 1;
}
console.log(`Bytes used: ${usedBytes / totalBytes * 100}%`);
</code>

Чтобы вывести покрытие в форме, доступной для [[https://github.com/istanbuljs|Стамбула]] , см. [[https://github.com/istanbuljs/puppeteer-to-istanbul|Puppeteer-to-istanbul]] .

==== coverage.startCSSCoverage%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Набор настраиваемых параметров покрытия
    * ''resetOnNavigation'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Сбрасывать ли покрытие при каждой навигации. По умолчанию ''true'' .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Обещание, которое разрешается при запуске покрытия

==== coverage.startJSCoverage%%([%%options]) ====

  * ''options'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > Набор настраиваемых параметров покрытия
    * ''resetOnNavigation'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Сбрасывать ли покрытие при каждой навигации. По умолчанию ''true'' .
    * ''reportAnonymousScripts'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type|boolean]] > Следует ли сообщать анонимные сценарии, созданные страницей. По умолчанию - ''false'' .
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] > Обещание, которое разрешается при запуске покрытия

> **ПРИМЕЧАНИЕ.** Анонимные сценарии - это сценарии, не связанные с URL-адресом. Это скрипты, которые динамически создаются на странице с помощью ''eval'' или ''new Function'' . Если для параметра ''reportAnonymousScripts'' установлено значение ''true'' , анонимные скрипты будут иметь ''%%__%%puppeteer_evaluation_script%%__%%'' в качестве URL-адреса. 

==== coverage.stopCSSCoverage() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >>> Promise, которое преобразуется в массив отчетов о покрытии для всех таблиц стилей
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > URL таблицы стилей
    * ''text'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > содержимое таблицы стилей
    * ''ranges'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Массив]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Объект]] >> Использованные диапазоны таблицы стилей. Диапазоны отсортированы и не перекрываются.
      * ''start'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Начальное смещение в тексте включительно
      * ''end'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Конечное смещение в тексте, исключая

> **ПРИМЕЧАНИЕ.** CSS Coverage не включает динамически вводимые теги стиля без sourceURL. 

==== coverage.stopJSCoverage() ====

  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >>> Promise, которое преобразуется в массив отчетов о покрытии для всех скриптов
    * ''url'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] > URL скрипта
    * ''text'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|string]] > Содержимое скрипта
    * ''ranges'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array|Array]] < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] >> Выполняемые диапазоны скриптов. Диапазоны отсортированы и не перекрываются.
      * ''start'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > Начальное смещение в тексте включительно
      * ''end'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|number]] > Конечное смещение в тексте, исключая

> **ПРИМЕЧАНИЕ.** Покрытие JavaScript по умолчанию не включает анонимные сценарии. Однако сообщается о скриптах с исходными URL. 

===== Класс:TimeoutError =====

  * расширяется: [[https://nodejs.org/api/errors.html#errors_class_error|Ошибка]]

TimeoutError генерируется всякий раз, когда определенные операции завершаются из-за тайм-аута, например [[#pagewaitforselectorselector-options|page.waitForSelector (selector [, options])]] или [[#puppeteerlaunchoptions|puppeteer.launch ([options])]] .

===== class: EventEmitter =====

Небольшой класс EventEmitter, поддерживаемый [[https://github.com/developit/mitt/|Mitt]] .

==== eventEmitter.addListener(event, handler) ====

  * ''event'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Symbol_type|symbol]] > событие, из которого нужно удалить обработчик.
  * ''handler'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|Function]] > прослушиватель событий, который будет добавлен.
  * возвращает: ''this'' так, чтобы вы могли связать вызовы методов

Этот метод идентичен ''on'' и поддерживается для совместимости с EventEmitter узла. Мы рекомендуем использовать ''on'' умолчанию.

==== eventEmitter.emit(event, [eventData]) ====

  * ''event'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Symbol_type|символ]] > инициируемое событие.
  * ''eventData'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object|Object]] > дополнительные данные для отправки с событием.
  * возвращает: ''boolean'' ; ''true'' если для события есть слушатели, и значение ''false'' , если их нет.

==== eventEmitter.listenerCount(event) ====

  * ''event'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Symbol_type|символ]] > событие для проверки слушателей.
  * возвращает: < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type|число]] > количество слушателей для данного события.

==== eventEmitter.off(event, handler) ====

  * ''event'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Symbol_type|symbol]] > событие, из которого нужно удалить обработчик.
  * ''handler'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|Function]] > прослушиватель событий, который будет удален.
  * возвращает: ''this'' так, чтобы вы могли связать вызовы методов

==== eventEmitter.on(event, handler) ====

  * ''event'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Symbol_type|symbol]] > событие, к которому нужно добавить обработчик.
  * ''handler'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|Function]] > прослушиватель событий, который будет добавлен.
  * возвращает: ''this'' так, чтобы вы могли связать вызовы методов

==== eventEmitter.once(event, handler) ====

  * ''event'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Symbol_type|symbol]] > событие, к которому нужно добавить обработчик.
  * ''handler'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|Function]] > прослушиватель событий, который будет добавлен.
  * возвращает: ''this'' так, чтобы вы могли связать вызовы методов

==== eventEmitter.removeAllListeners%%([%%event]) ====

  * ''event'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Symbol_type|символ]] > необязательный аргумент для удаления всех слушателей для данного события. Если он не указан, этот метод удалит всех слушателей для всех событий.
  * возвращает: ''this'' так, чтобы вы могли связать вызовы методов

==== eventEmitter.removeListener(event, handler) ====

  * ''event'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type|строка]] | [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Symbol_type|symbol]] > событие, из которого нужно удалить обработчик.
  * ''handler'' < [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function|Function]] > прослушиватель событий, который будет удален.
  * возвращает: ''this'' так, чтобы вы могли связать вызовы методов

Этот метод идентичен ''off'' и поддерживается для совместимости с EventEmitter узла. Мы рекомендуем по умолчанию ''off'' .

===== interface: CustomQueryHandler =====

Содержит две функции ''queryOne'' и ''queryAll'' , которые можно [[#puppeteerregistercustomqueryhandlername-queryhandler|зарегистрировать]] как альтернативные стратегии запросов. Функции ''queryOne'' и ''queryAll'' выполняются в контексте страницы. ''queryOne'' должен принимать в качестве аргумента ''Element'' и строку селектора и возвращать один ''Element'' или значение ''null'' , если элемент не найден. ''queryAll'' принимает те же аргументы, но вместо этого должен возвращать ''NodeList<Element>'' или ''Array<Element>'' со всеми элементами, соответствующими заданному селектору запроса.