Module user_agent

Generate context data from user agent and client hints.

This module is responsible for taking the user agent string parsing it and filling in the browser, os and device information in the event.

NOTICE

Adding user_agent parsing to your module will incur a latency penalty in the test suite. Because of this some integration tests may fail. To fix this, you will need to add a timeout to your consumer.

Structs

• ClientHints
  The client hint variable names mirror the name of the “SEC-CH” headers.
• RawUserAgentInfo
  A container housing both the user-agent string and the client hint headers.

Traits

• FromUserAgentInfo
  Computes a Context from either a user agent string and client hints.

Functions

• browser_from_client_hints
  The sec-ch-ua field looks something like this: “Not_A Brand”;v=“99”, “Google Chrome”;v=“109”, “Chromium”;v=“109” The order of the items are randomly shuffled.
• normalize_user_agent
  Generates context data from client hints or user agent.
• normalize_user_agent_info_generic
  Low-level version of normalize_user_agent operating on parts.