diff --git a/README.md b/README.md index f8097ab..3b85b02 100644 --- a/README.md +++ b/README.md @@ -141,9 +141,9 @@ Manipulate HTTP request headers with Ferrum: ``` ruby page.driver.browser.headers.get # => {} -page.driver.browser.headers.set("User-Agent" => "Cuprite") +page.driver.browser.headers.set("X-Trace" => "1") page.driver.browser.headers.add({ "Referer" => "https://example.com" }) -page.driver.browser.headers.get # => { "User-Agent" => "Cuprite", "Referer" => "https://example.com" } +page.driver.browser.headers.get # => { "X-Trace" => "1", "Referer" => "https://example.com" } ``` Notice that `set` will overwrite already set headers. You should use `add` if diff --git a/docs/1-introduction.md b/docs/1-introduction.md index 57e74a8..098a6e6 100644 --- a/docs/1-introduction.md +++ b/docs/1-introduction.md @@ -79,7 +79,7 @@ Capybara has no API for what you need: ```ruby browser = page.driver.browser -browser.headers.set("Accept-Language" => "de") +browser.network.emulate(accept_language: "de") browser.cookies.set(name: "stealth", value: "omg") browser.network.wait_for_idle browser.network.traffic.last.response.status # => 200 diff --git a/docs/11-headers.md b/docs/11-headers.md index 174f0cf..0b97431 100644 --- a/docs/11-headers.md +++ b/docs/11-headers.md @@ -11,9 +11,9 @@ They are cleared at the end of every test. ```ruby headers = page.driver.browser.headers headers.get # => {} -headers.set("User-Agent" => "Cuprite") -headers.add({ "Accept-Language" => "de" }) -headers.get # => { "User-Agent" => "Cuprite", "Accept-Language" => "de" } +headers.set("X-Trace" => "1") +headers.add({ "X-Tenant" => "acme" }) +headers.get # => { "X-Trace" => "1", "X-Tenant" => "acme" } ``` `set` overwrites already set headers, `add` merges into them. A `Referer` @@ -23,3 +23,12 @@ it to `go_to`: ```ruby page.driver.browser.go_to("/landing", referrer: "https://example.com") ``` + +To change the user agent or the language use Ferrum's +[network.emulate](/docs/ferrum/network), which overrides the `User-Agent` and +`Accept-Language` headers together with what `navigator` reports. It is reset +at the end of every test too: + +```ruby +page.driver.browser.network.emulate(user_agent: "Cuprite", accept_language: "de") +``` diff --git a/docs/2-customization.md b/docs/2-customization.md index eef5e70..91a4608 100644 --- a/docs/2-customization.md +++ b/docs/2-customization.md @@ -34,7 +34,7 @@ Cuprite-specific options are: * `:emulate` (Symbol) - Device to emulate, one of those listed in Chrome DevTools' device toolbar, such as `:iphone_16`, `:pixel_9`, `:samsung_galaxy_a55` or `:ipad_mini`, see `Capybara::Cuprite::Devices::LIST`. It sets the device's `:window_size`, `:scale_factor` and `:mobile`, options passed explicitly take precedence, and its - user agent, unless a `User-Agent` is set with [headers](/docs/cuprite/headers). + user agent, unless one is set with `network.emulate(user_agent:)`, see [headers](/docs/cuprite/headers). * `:mobile` (Boolean) - Emulate a mobile device: honor `` and enable touch events, `false` by default. Kept across window resizes. * `:scale_factor` (Numeric) - Device scale factor (`window.devicePixelRatio`) to emulate, `0` (browser default)