nginstack

Module: @nginstack/engine/lib/useragent/parseUserAgent

(require("@nginstack/engine/lib/useragent/parseUserAgent"))(userAgent)

Interpreta um user-agent e retorna uma estrutura com browser, device e sistema operacional.

Parameters:
Name Type Description
userAgent string

User-agent a ser interpretado.
Returns:

Informações estruturadas do user-agent.

Type
UserAgentInfo
Example
const parseUserAgent = require('@nginstack/engine/lib/useragent/parseUserAgent.js');

const info = parseUserAgent(
  'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ' +
  '(KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36'
);

info.browser.name; // => 'Chrome'
info.os.name; // => 'Windows'

Type Definitions

UserAgentBrowser

Informações sobre o navegador identificado no user-agent.

Type:
  • Object
Properties:
Name Type Description
name string

Nome do navegador.
version string

Versão completa do navegador.
major string

Número de versão principal.

UserAgentDevice

Informações sobre o dispositivo identificado no user-agent.

Type:
  • Object
Properties:
Name Type Description
type string

Tipo do dispositivo. Valores possíveis: 'mobile', 'tablet', 'desktop' e 'bot'. Será uma string vazia quando o tipo não puder ser identificado.
vendor string

Fabricante do dispositivo. Será uma string vazia quando não puder ser identificado.
model string

Modelo do dispositivo. Será uma string vazia quando não puder ser identificado.

UserAgentInfo

Informações extraídas de um user-agent.

Type:
  • Object
Properties:
Name Type Description
userAgent string

String original do user-agent recebida como argumento.
browser UserAgentBrowser

Informações sobre o navegador.
device UserAgentDevice

Informações sobre o dispositivo.
os UserAgentOS

Informações sobre o sistema operacional.

UserAgentOS

Informações sobre o sistema operacional identificado no user-agent.

Type:
  • Object
Properties:
Name Type Description
name string

Nome do sistema operacional.
version string

Versão do sistema operacional. Será uma string vazia quando a versão não puder ser identificada.