schickling/chromeless là dự án TypeScript với 13.2k sao trong nhóm Automation. 🖥 Chrome automation made simple. Runs locally or headless on AWS Lambda.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
This project is deprecated in favor for Puppeteer.
Thanks to all the contributors who made this project possible.
Chromeless
Chrome automation made simple. Runs locally or headless on AWS Lambda. (See Demo)
Chromeless can be used to...
Run 1000s of browser integration tests in parallel ⚡️
Crawl the web & automate screenshots
Write bots that require a real browser
Do pretty much everything you've used PhantomJS, NightmareJS or Selenium for before
Examples
JSON of Google Results: Google for chromeless and get a list of JSON results
Screenshot of Google Results: Google for chromeless and take a screenshot of the results
prep: Compile-time prerendering for SPA/PWA (like React, Vue...) instead of server-side rendering (SSR)
See the full examples list for more
▶️ Try it out
You can try out Chromeless and explore the API in the browser-based demo playground (source).
Contents
How it works
Installation
Usage
API Documentation
Configuring Development Environment
FAQ
Contributors
Credits
Help & Community
How it works
With Chromeless you can control Chrome (open website, click elements, fill out forms...) using an elegant API. This is useful for integration tests or any other scenario where you'd need to script a real browser.
There are 2 ways to use Chromeless
Running Chrome on your local computer
Running Chrome on AWS Lambda and controlling it remotely
1. Local Setup
For local development purposes where a fast feedback loop is necessary, the easiest way to use Chromeless is by controlling your local Chrome browser. Just follow the usage guide to get started.
2. Remote Proxy Setup
You can also run Chrome in headless-mode on AWS Lambda. This way you can speed up your tests by running them in parallel. (In Graphcool's case this decreased test durations from ~20min to a few seconds.)
Chromeless comes out of the box with a remote proxy built-in - the usage stays completely the same. This way you can write and run your tests locally and have them be executed remotely on AWS Lambda. The proxy connects to Lambda through a Websocket connection to forward commands and return the evaluation results.
Installation
npm install chromeless
Proxy Setup
The project contains a Serverless service for running and driving Chrome remotely on AWS Lambda.
Deploy The Proxy service to AWS Lambda. More details here
Follow the usage instructions here.
Usage
Using Chromeless is similar to other browser automation tools. For example:
const { Chromeless } = require('chromeless')
async function run() {
const chromeless = new Chromeless()
const screenshot = await chromeless
.goto('https://www.google.com')
.type('chromeless', 'input[name="q"]')
.press(13)
.wait('#resultStats')
.screenshot()
console.log(screenshot) // prints local file path or S3 url
await chromeless.end()
}
run().catch(console.error.bind(console))
Local Chrome Usage
To run Chromeless locally, you need a recent version of Chrome or Chrome Canary installed (version 60 or greater). By default, chromeless will start Chrome automatically and will default to the most recent version found on your system if there's multiple. You can override this behavior by starting Chrome yourself, and passing a flag of launchChrome: false in the Chromeless constructor.
To launch Chrome yourself, and open the port for chromeless, follow this example:
alias canary="/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary"
canary --remote-debugging-port=9222
cd "C:\Program Files (x86)\Google\Chrome\Application"
chrome --remote-debugging-port=9222 --disable-gpu --headless
Proxy Usage
Follow the setup instructions here.
Then using Chromeless with the Proxy service is the same as running it locally with the exception of the remote option.
Alternatively you can configure the Proxy service's endpoint with environment variables. Here's how.
Now your local chromeless scripts will use your local development of chromeless.
FAQ
How is this different from NightmareJS, PhantomJS or Selenium?
The Chromeless API is very similar to NightmareJS as their API is pretty awesome. The big difference is that Chromeless is based on Chrome in headless-mode, and runs in a serverless function in AWS Lambda. The advantage of this is that you can run hundreds of browsers in parallel, without having to think about parallelisation. Running integration Tests for example is much faster.
I'm new to AWS Lambda, is this still for me?
You still can use this locally without Lambda, so yes. Besides that, here is a simple guide on how to set the lambda function up for Chromeless.
How much does it cost to run Chromeless in production?
The compute price is $0.00001667 per GB-s and the free tier provides 400,000 GB-s. The request price is $0.20 per 1 million requests and the free tier provides 1M requests per month.
This means you can easily execute > 100.000 tests for free in the free tier.
Are there any limitations?
If you're running Chromeless on AWS Lambda, the execution cannot take longer than 5 minutes which is the current limit of Lambda. Besides that, every feature that's supported in Chrome is also working with Chromeless. The maximal number of concurrent function executions is 1000. AWS API Limits
Are there commercial options?
Although Chromeless is the easiest way to get started running Chrome on Lambda, you may not have time to build and manage your own visual testing toolkit. Commercial options include:
Chromatic: Visual snapshot regression testing for Storybook.
Troubleshooting
Error: Unable to get presigned websocket URL and connect to it.
In case you get an error like this when running the Chromeless client:
{ HTTPError: Response code 403 (Forbidden)
at stream.catch.then.data (/code/chromeless/node_modules/got/index.js:182:13)
at process._tickDomainCallback (internal/process/next_tick.js:129:7)
name: 'HTTPError',
...
Error: Unable to get presigned websocket URL and connect to it.
Make sure that you're running at least version 1.19.0 of serverless. It is a known issue, that the API Gateway API keys are not setup correctly in older Serverless versions. Best is to run npm run deploy within the project as this will use the local installed version of serverless.
Resource ServerlessDeploymentBucket does not exist for stack chromeless-serverless-dev
In case the deployment of the serverless function returns an error like this:
Serverless Error ---------------------------------------
Resource ServerlessDeploymentBucket does not exist for stack chromeless-serverless-dev
Please check, that there is no stack with the name chromeless-serverless-dev existing yet, otherwise serverless can't correctly provision the bucket.
No command gets executed
In order for the commands to be processed, make sure, that you call one of the commands screenshot, evaluate, cookiesGetAll or end at the end of your execution chain.
Contributors
A big thank you to all contributors and supporters of this repository 💚
Credits
chrome-remote-interface: Chromeless uses this package as an interface to Chrome
serverless-chrome: Compiled Chrome binary that runs on AWS Lambda (Azure and GCP soon, too.)
NightmareJS: We draw a lot of inspiration for the API from this great tool
Help & Community
Join our Slack community if you run into issues or have questions. We love talking to you!
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/schickling/chromeless là nguồn chính thức.
schickling/chromeless có bao nhiêu sao?
schickling/chromeless có 13.2k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/schickling/chromeless. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
schickling/chromeless có những chủ đề gì?
GitHub topics của schickling/chromeless: "chrome", "graphcool", "headless", "headless-chrome", "integration-testing", "nightmarejs", "selenium", "serverless". TopGit xếp repo vào nhóm Automation.
schickling/chromeless có trang demo không?
Dự án có trang chủ ở https://chromeless.netlify.com. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
schickling/chromeless còn đang phát triển không?
Commit gần nhất trên schickling/chromeless là 8.0 năm trước (theo timestamp GitHub). Repo có 569 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
schickling/chromeless dùng license gì?
schickling/chromeless phát hành theo license MIT. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
schickling/chromeless viết bằng ngôn ngữ gì?
schickling/chromeless chủ yếu viết bằng TypeScript. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Đọc đầy đủ README ở tab phía trên.
Muốn nghe thêm một ý kiến về chromeless?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về chromeless.