Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 # Headless Chromium | 1 # Headless Chromium |
| 2 | 2 |
| 3 Headless Chromium is a library for running Chromium in a headless/server | 3 Headless Chromium is a library for running Chromium in a headless/server |
| 4 environment. Expected use cases include loading web pages, extracting metadata | 4 environment. Expected use cases include loading web pages, extracting metadata |
| 5 (e.g., the DOM) and generating bitmaps from page contents -- using all the | 5 (e.g., the DOM) and generating bitmaps from page contents -- using all the |
| 6 modern web platform features provided by Chromium and Blink. | 6 modern web platform features provided by Chromium and Blink. |
| 7 | 7 |
| 8 ## Headless shell | 8 ## Headless shell |
| 9 | 9 |
| 10 The headless shell is a sample application which demonstrates the use of the | 10 The headless shell is a sample application which demonstrates the use of the |
| 11 headless API. To run it, first open the build configuration editor: | 11 headless API. To run it, first initialize a headless build configuration: |
| 12 | 12 |
| 13 ``` | 13 ``` |
| 14 $ gn args out/Release | 14 $ mkdir -p out/Release |
| 15 $ echo 'import("//build/args/headless.gn")' > out/Release/args.gn | |
| 16 $ gn gen out/Release | |
|
Dirk Pranke
2016/03/31 01:47:30
//build/args/headless.gn in this patchset will pro
Sami
2016/03/31 09:43:02
Ah, good point. Changed this to talk about debug i
| |
| 15 ``` | 17 ``` |
| 16 | 18 |
| 17 and enable headless mode with `is_headless = true`. | |
| 18 | |
| 19 Then build the shell: | 19 Then build the shell: |
| 20 | 20 |
| 21 ``` | 21 ``` |
| 22 $ ninja -C out/Release headless_shell | 22 $ ninja -C out/Release headless_shell |
| 23 ``` | 23 ``` |
| 24 | 24 |
| 25 After the build completes, the headless shell can be run with the following | 25 After the build completes, the headless shell can be run with the following |
| 26 command: | 26 command: |
| 27 | 27 |
| 28 ``` | 28 ``` |
| (...skipping 23 matching lines...) Expand all Loading... | |
| 52 - `SetProxyServer` - Configures an HTTP/HTTPS proxy server to be used for | 52 - `SetProxyServer` - Configures an HTTP/HTTPS proxy server to be used for |
| 53 accessing the network. | 53 accessing the network. |
| 54 | 54 |
| 55 ## Client API | 55 ## Client API |
| 56 | 56 |
| 57 The headless client API is used to drive the browser and interact with loaded | 57 The headless client API is used to drive the browser and interact with loaded |
| 58 web pages. Its main classes are: | 58 web pages. Its main classes are: |
| 59 | 59 |
| 60 - `HeadlessBrowser` - Represents the global headless browser instance. | 60 - `HeadlessBrowser` - Represents the global headless browser instance. |
| 61 - `HeadlessWebContents` - Represents a single "tab" within the browser. | 61 - `HeadlessWebContents` - Represents a single "tab" within the browser. |
| OLD | NEW |