hubcap useragent

Override the browser’s user agent string.

When to use

Override the browser user agent string to test server-side user agent detection or mimic a specific browser or crawler. Use emulate for full device emulation including viewport and touch support alongside the user agent.

Usage

hubcap useragent <string>

Arguments

ArgumentTypeRequiredDescription
stringstringYesThe user agent string to set

Flags

None.

Output

FieldTypeDescription
userAgentstringThe user agent string that was set
{"userAgent":"Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)"}

Errors

ConditionExit codeStderr
Missing argument1usage: hubcap useragent <string>
Chrome not connected2error: connecting to Chrome: ...
Timeout3error: timeout

Examples

Pretend to be Googlebot:

hubcap useragent "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)"

Pretend to be a specific desktop browser:

hubcap useragent "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"

Set the user agent, navigate, and verify the server responded differently:

hubcap useragent "Googlebot/2.1" && hubcap goto https://example.com && hubcap text "body"

See also

  • emulate - Emulate a full device profile including viewport and touch
  • viewport - Set viewport dimensions
  • version - Print browser version information