Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/utyfua/automation-extra-interception-proxy
Simple way to play with a site requests and responses by the plugin for puppeteer-extra.
https://github.com/utyfua/automation-extra-interception-proxy
automation interceptors promises proxy puppeteer puppeteer-extra puppeteer-extra-plugin sniffer
Last synced: 3 months ago
JSON representation
Simple way to play with a site requests and responses by the plugin for puppeteer-extra.
- Host: GitHub
- URL: https://github.com/utyfua/automation-extra-interception-proxy
- Owner: utyfua
- License: mit
- Created: 2021-12-03T05:00:16.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-09-06T09:20:34.000Z (4 months ago)
- Last Synced: 2024-09-28T14:03:44.135Z (3 months ago)
- Topics: automation, interceptors, promises, proxy, puppeteer, puppeteer-extra, puppeteer-extra-plugin, sniffer
- Language: TypeScript
- Homepage:
- Size: 392 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# automation-extra-interception-proxy
Simple way to play with a site requests and responses.
Spiritual heir of [puppeteer-page-proxy](https://www.npmjs.com/package/puppeteer-page-proxy).
Just the same behavior but in more extend way with promises.
Using a proxy is optional.
Supported proxy(through [proxy-agent](https://www.npmjs.com/package/proxy-agent)):
* `http://proxy-server-over-tcp.com:3128`
* `https://proxy-server-over-tls.com:3129`
* `socks://username:[email protected]:9050` (username & password are optional)
* `socks5://username:[email protected]:9050` (username & password are optional)
* `socks4://some-socks-proxy.com:9050`
* `pac+http://www.example.com/proxy.pac`
Tested in `puppeteer/chromium` only!
## Table of Contents
* [Known issues in managed mode](#known-issues-in-managed-mode)
* [Installing](#installing)
* [Why?](#why)
* [Motivation](#motivation)
* [API](#api)
* [Samples](#samples)
* * [page proxy](#sample-page-proxy)
* * [single page interception](#single-page-interception)
* [Troubleshooting](#troubleshooting)
* [TODO](#todo)
## Known issues in managed mode
* Grease chips are missing.
* Some headers are missing.
* [CORS] OPTIONS requests (preflight requests) are missing before the actual request will be executed.
* [CORS] Headers are close to being correct, but they're not.
* WebSockets will be handled by the browser (IP leak may occur if you are using a proxy in the package but not in Puppeteer itself).
* Optimization can be bad on high load.
## Installing
Using npm
npm install automation-extra-interception-proxy
Using yarn
yarn add automation-extra-interception-proxy
# Why?
This package solves next problems:
## 1. Traffic sniffing
Time to time required to reach information from the browser request.
By default you can reach easily only to headers information.
If you want to just read all responses you also can do that but time to
time it will throw errors by one of next reasons.
At first page can be already closed and then your code will throw an error.
At second some sites using service workers for requesting some information.
Unfortunately you cant handle this situation without manual requesting and
then converting to puppeteer.
## 2. Data manipulation
If you want just adjust some requests or responses you should do that manually.
Example. You want get original request/response and do some adjustments.
This package will help do that easily. You just getting what you want by single function call.
## 3. Set proxy
Yes, puppeteer already have a proxy support throw additional process arguments.
But you should manually maintain proxy credentials each request(?, not sure).
Also you cant use socks proxy(?, not sure).
## 4. Asynchronous decisions for requests
Even with cooperative mode you can not make your decisions asynchronously.
Here you can chain of handlers with will proceed request decision one by one.
Also you can say that this is latest decision and no need to ask another handlers in the chain.
Also in one handler you can can adjust request/response for the next one.
# Motivation
We live in the world where almost each website have internal api.
When you are looking at the network tab in Chrome DevTools its easy to handle where and what.
Data already yours but you cant just get what you want.
But you have to fight for the information you desired for.
So lets fight together!
# API
### Table of Contents
* [wrapPage](#wrappage)
* [Parameters](#parameters)
* [IConfig](#iconfig)
* [cooperativePriority](#cooperativepriority)
* [requestMode](#requestmode)
* [proxy](#proxy)
* [agent](#agent)
* [logger](#logger)
* [timeout](#timeout)
* [nativeContinueIfPossible](#nativecontinueifpossible)
* [ignoreResponseBodyIfPossible](#ignoreresponsebodyifpossible)
* [enableLegacyCookieHandling](#enablelegacycookiehandling)
* [gotHooks](#gothooks)
* [continue](#continue)
* [ignoreResponseBodyIfPossible](#ignoreresponsebodyifpossible-1)
* [flushLocal](#flushlocal)
* [Parameters](#parameters-1)
* [recordError](#recorderror)
* [Parameters](#parameters-2)
* [recordInternalError](#recordinternalerror)
* [Parameters](#parameters-3)
* [recordWarning](#recordwarning)
* [Parameters](#parameters-4)
* [RequestMode](#requestmode-1)
* [ignore](#ignore)
* [native](#native)
* [managed](#managed)
* [RequestStage](#requeststage)
* [gotRequest](#gotrequest)
* [sentRequest](#sentrequest)
* [gotResponse](#gotresponse)
* [sentResponse](#sentresponse)
* [closed](#closed)
* [IRequestOptions](#irequestoptions)
* [method](#method)
* [url](#url)
* [headers](#headers)
* [body](#body)
* [\_bodyError](#\_bodyerror)
* [IAbortReason](#iabortreason)
* [InterceptionProxyRequest](#interceptionproxyrequest)
* [Parameters](#parameters-5)
## wrapPage
[src/index.ts:22-24](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/index.ts#L22-L24 "Source code on GitHub")
Add interception ability to the page [(sample)](https://github.com/utyfua/automation-extra-interception-proxy/blob/master/samples/singlePageInterception.js)
### Parameters
* `page` **Puppeteer.Page** Page for future interceptions
* `config` **[IConfig](#iconfig)?**
Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\**
## IConfig
[src/interfaces/base.ts:41-132](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L41-L132 "Source code on GitHub")
Plugin configuration object
### cooperativePriority
[src/interfaces/base.ts:51-51](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L51-L51 "Source code on GitHub")
Puppeteer' "Cooperative Intercept Mode" `priority`
This package using own way to manage cooperation
Use only if you know what it does
[\[Read more\]](https://github.com/puppeteer/puppeteer/blob/v10.2.0/docs/api.md#cooperative-intercept-mode-and-legacy-intercept-mode)
Type: ([undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined) | [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number))
### requestMode
[src/interfaces/base.ts:61-61](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L61-L61 "Source code on GitHub")
`ignore` - Plugin will do nothing about original request
`native` - Plugin will just listen to the original request/response data and all requests will fulfilled by puppeteer itself. But some plugin functionality can be unavailable.
`managed` - Plugin will do all requests by `requestHandlers` or by himself. All plugin features will be available.
Default - managed
Type: [RequestMode](#requestmode)
### proxy
[src/interfaces/base.ts:77-77](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L77-L77 "Source code on GitHub")
Proxy for request
Automatically sets `agent` property using [proxy-agent](https://www.npmjs.com/package/proxy-agent)
Examples:
* `http://proxy-server-over-tcp.com:3128`
* `https://proxy-server-over-tls.com:3129`
* `socks://username:[email protected]:9050` (username & password are optional)
* `socks5://username:[email protected]:9050` (username & password are optional)
* `socks4://some-socks-proxy.com:9050`
* `pac+http://www.example.com/proxy.pac`
Default `null`
Type: ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | null)
### agent
[src/interfaces/base.ts:88-88](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L88-L88 "Source code on GitHub")
Your agent hot handling requests
Sets by `proxy` property. Cleans `proxy` property if sets directly.
Default `null`
Type: (Agent | null)
**Meta**
* **deprecated**: Use `proxy` property instead.
Deprecated because of possibly incoming request handling rework.
### logger
[src/interfaces/base.ts:92-92](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L92-L92 "Source code on GitHub")
You can handle all plugins messages
Type: any
### timeout
[src/interfaces/base.ts:96-96](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L96-L96 "Source code on GitHub")
Request timeout in milliseconds(actual execution only)
Type: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)
### nativeContinueIfPossible
[src/interfaces/base.ts:103-103](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L103-L103 "Source code on GitHub")
If you didn't changed request or response, let puppeteer handle this request by himself
Default: `false`
Type: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)
### ignoreResponseBodyIfPossible
[src/interfaces/base.ts:113-113](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L113-L113 "Source code on GitHub")
If you did not use the plugin' response object it will not retrieve response from puppeteer
for better performance
Applies for `native` mode only
Type: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)
### enableLegacyCookieHandling
[src/interfaces/base.ts:121-121](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L121-L121 "Source code on GitHub")
For old versions of puppeteer, plugin should handle cookies by himself.
Enable this option, if you are have an issue with cookie.
Recommended to upgrade your puppeteer version instead.
Type: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)
### gotHooks
[src/interfaces/base.ts:129-129](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/base.ts#L129-L129 "Source code on GitHub")
* **See**:
It is not recommended to use. Use another library properties to do it.
Modify requests in more advanced way through interaction with got.
Type: Hooks
## continue
[src/interfaces/classes.ts:42-42](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/classes.ts#L42-L42 "Source code on GitHub")
Will send gathered response back to the puppeteer immediately
If response not collected yet will call getResponse first.
Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\**
## ignoreResponseBodyIfPossible
[src/interfaces/mixins.ts:14-14](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/mixins.ts#L14-L14 "Source code on GitHub")
If you are using this specific method global `ignoreResponseBodyIfPossible` will be ignored
Type: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)
## flushLocal
[src/interfaces/mixins.ts:43-43](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/mixins.ts#L43-L43 "Source code on GitHub")
Flush local configuration
### Parameters
* `key` **any?** If provided will flush only specific parameter at local level
Returns **void**
## recordError
[src/interfaces/mixins.ts:55-59](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/mixins.ts#L55-L59 "Source code on GitHub")
Pass an error to the logger
### Parameters
* `message` **any** Flow description
* `error` **any?** Original error object
* `meta` **...any** non specific meta information
Returns **void**
## recordInternalError
[src/interfaces/mixins.ts:65-68](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/mixins.ts#L65-L68 "Source code on GitHub")
Pass an internal error to the logger
### Parameters
* `message` **any** Flow/error description
* `meta` **...any** non specific meta information
Returns **void**
## recordWarning
[src/interfaces/mixins.ts:74-77](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/mixins.ts#L74-L77 "Source code on GitHub")
Pass an warn to the logger
### Parameters
* `message` **any** Flow/error description
* `meta` **...any** non specific meta information
Returns **void**
## RequestMode
[src/interfaces/network.ts:7-21](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L7-L21 "Source code on GitHub")
Plugin mode for handling requests
### ignore
[src/interfaces/network.ts:11-11](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L11-L11 "Source code on GitHub")
Plugin will do nothing about original request
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
### native
[src/interfaces/network.ts:16-16](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L16-L16 "Source code on GitHub")
Plugin will just listen to the original request/response data and all requests will fulfilled by puppeteer itself.
But some plugin functionality can be unavailable.
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
### managed
[src/interfaces/network.ts:20-20](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L20-L20 "Source code on GitHub")
Plugin will do all requests by himself. All plugin features will be available.
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
## RequestStage
[src/interfaces/network.ts:26-65](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L26-L65 "Source code on GitHub")
Current stage of the request
### gotRequest
[src/interfaces/network.ts:35-35](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L35-L35 "Source code on GitHub")
We got a new request from the puppeteer witch includes all necessary information about.
At this stage we can adjust request.
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
### sentRequest
[src/interfaces/network.ts:42-42](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L42-L42 "Source code on GitHub")
The request in requesting process
At this stage we unable to adjust request but still have not response to go forward.
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
### gotResponse
[src/interfaces/network.ts:50-50](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L50-L50 "Source code on GitHub")
We got response from the request witch probably was modified by the user and now user can adjust the response.
At this stage we can adjust response.
At this stage the user will unable to override the request anymore.
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
### sentResponse
[src/interfaces/network.ts:57-57](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L57-L57 "Source code on GitHub")
We sent final response of the request to the browser.
Its too late to adjust request or response.
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
### closed
[src/interfaces/network.ts:64-64](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L64-L64 "Source code on GitHub")
Page were closed and we unable do anything
From technical perspective `sentResponse` looks just the same
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
## IRequestOptions
[src/interfaces/network.ts:72-100](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L72-L100 "Source code on GitHub")
Plugin' request options. The request have significant difference with Puppeteer' request.
Can be modified. All changes will be applied to the actual Puppeteer' request and will be executed
### method
[src/interfaces/network.ts:78-78](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L78-L78 "Source code on GitHub")
Request method.
If request were executed you will unable to change this property.
Type: Method
### url
[src/interfaces/network.ts:85-85](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L85-L85 "Source code on GitHub")
Request url.
If request were executed you will unable to change this property.
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
### headers
[src/interfaces/network.ts:92-92](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L92-L92 "Source code on GitHub")
Request headers.
If request were executed you will unable to change this property.
Type: [Headers](https://developer.mozilla.org/docs/Web/HTML/Element/header)
### body
[src/interfaces/network.ts:99-99](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L99-L99 "Source code on GitHub")
Request body.
If request were executed you will unable to change this property.
Type: ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [Buffer](https://nodejs.org/api/buffer.html) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))
## \_bodyError
[src/interfaces/network.ts:108-108](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L108-L108 "Source code on GitHub")
Type: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
## IAbortReason
[src/interfaces/network.ts:129-129](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/interfaces/network.ts#L111-L128 "Source code on GitHub")
This option will override the response
* `aborted` - An operation was aborted (due to user action).
* `accessdenied` - Permission to access a resource, other than the network, was denied.
* `addressunreachable` - The IP address is unreachable. This usually means
that there is no route to the specified host or network.
* `blockedbyclient` - The client chose to block the request.
* `blockedbyresponse` - The request failed because the response was delivered along with requirements which are not met ('X-Frame-Options' and 'Content-Security-Policy' ancestor checks, for instance).
* `connectionaborted` - A connection timed out as a result of not receiving an ACK for data sent.
* `connectionclosed` - A connection was closed (corresponding to a TCP FIN).
* `connectionfailed` - A connection attempt failed.
* `connectionrefused` - A connection attempt was refused.
* `connectionreset` - A connection was reset (corresponding to a TCP RST).
* `internetdisconnected` - The Internet connection has been lost.
* `namenotresolved` - The host name could not be resolved.
* `timedout` - An operation timed out.
* `failed` - A generic failure occurred.
Type: ErrorCode
## InterceptionProxyRequest
[src/classes/Request.ts:40-236](https://github.com/utyfua/automation-extra-interception-proxy/blob/241889ecffda764e073601ebd400755bc5ce7879/src/classes/Request.ts#L40-L236 "Source code on GitHub")
**Extends RequestBase**
Plugin' request. The request have significant difference with Puppeteer' request.
### Parameters
* `initial` **INewRequestInitialArgs**
* `requestOptions` **[IRequestOptions](#irequestoptions)**
# Samples
## [Page proxy](https://github.com/utyfua/automation-extra-interception-proxy/blob/master/samples/pageProxy.js)
```js
/**
* This example will show how to enable proxy for single page.
*/
// require libs
const puppeteer = require('puppeteer');
const InterceptionUtils = require('automation-extra-interception-proxy');
// do everything async
(async () => {
// launch some browser
const browser = await puppeteer.launch({
headless: false,
});
// get some page
const page = await browser.newPage();
// attach interception commands
await InterceptionUtils.wrapPage(page, {
requestMode: "managed",
// optional, will be handled by https://www.npmjs.com/package/proxy-agent
proxy: "socks5://username:[email protected]:9050"
});
// goto to our destination and wait for the response
await page.goto('https://www.npmjs.com/package/automation-extra-interception-proxy');
// closing browser
await browser.close();
})(); // ent of our thread
```
## [single page interception](https://github.com/utyfua/automation-extra-interception-proxy/blob/master/samples/singlePageInterception.js)
```js
/**
* This example will show how to enable interceptions for single page.
*
* This code will get some wallpaper image urls from bing.com
*
* This code could be broken if their behavior was changed.
*/
// require libs
const puppeteer = require('puppeteer');
const InterceptionUtils = require('automation-extra-interception-proxy');
// do everything async
(async () => {
// launch some browser
const browser = await puppeteer.launch({
headless: false,
});
// get some page
const page = await browser.newPage();
// attach interception commands
await InterceptionUtils.wrapPage(page, {
requestMode: "managed",
// optional, will be handled by https://www.npmjs.com/package/proxy-agent
// proxy: "socks5://username:[email protected]:9050"
});
// create promise callback for async processing
let callback;
const promise = new Promise((resolve) => { callback = resolve; });
// add some listener
page.interceptions.addRequestListener('bing-images', async request => {
// filter anything else
if (request.url !== 'https://www.bing.com/hp/api/model') {
// just letting you know that we got something else here
console.log('Ignoring', request.url.slice(0, 50));
return
}
// get response data
const response = await request.getResponse();
// grab data directly from their api response
const apiData = response.json;
// doing anything you like
const imageUrls = apiData.MediaContents.map(({ ImageContent }) =>
`https://www.bing.com${ImageContent.Image.Url}`);
// back to async thread
callback(imageUrls);
}); // end of listener
// goto to our destination and wait for the response
const [imageUrls] = await Promise.all([
promise,
page.goto('https://www.bing.com/'),
]);
// print our image urls
console.log('imageUrls', imageUrls);
// not necessary: cleaning our listener
page.interceptions.deleteLocalRequestListener('bing-images');
// closing browser
await browser.close();
})(); // ent of our thread
```
## [Open other samples](https://github.com/utyfua/automation-extra-interception-proxy/tree/master/samples)
# Troubleshooting
## Cookies does not work
Probably you're using old version of puppeteer. Try you upgrade first.
In case if you don't want to or cookies still does not work enable
[enableLegacyCookieHandling](#enablelegacycookiehandling).
## Does cors requests are broken?
Yes, the implementation is still raw.
# TODO:
* finalize cors managed requests - need to pass cors test
* add tests
* * plugin flow
* documentation
* * improve `docs` command
* * describe `wrapPage`
* * describe `InterceptionProxyPlugin` class
* add more proxy api
* * waitRequest
* websocket support
* migrate to [automation-extra-plugin](https://www.npmjs.com/package/automation-extra-plugin)
* support Grease cipher
# License
Copyright © 2021 - 2023, Utyfua. Released under the MIT License.