# @types/user-agents

> TypeScript definitions for user-agents

Latest version **1.0.4** (published 2023-11-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install @types/user-agents
pnpm add @types/user-agents
yarn add @types/user-agents
bun add @types/user-agents
```

## Health

**Score 45/100 (D)** — status: abandoned.

Positive: has types; no vulnerabilities; high maintenance score; popular repo; extremely popular.

Warnings: low downloads; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 1.0.4 |
| Published | 2023-11-07 |
| First published | 2019-12-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 6.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 51449 |
| Maintainers | types |

## Links

- npm: https://www.npmjs.com/package/@types/user-agents
- Repository: https://github.com/DefinitelyTyped/DefinitelyTyped
- Homepage: https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/user-agents
- npm.io page: https://npm.io/package/@types/user-agents

## Recent versions

- 1.0.4 (latest) — 2023-11-07
- 1.0.2 (ts3.6) — 2021-07-02
- 1.0.1 (ts3.5) — 2021-04-19
- 1.0.0 (ts2.8) — 2019-12-26
- 1.0.3 — 2023-10-18

## README

# Installation
> `npm install --save @types/user-agents`

# Summary
This package contains type definitions for user-agents (https://github.com/intoli/user-agents#readme).

# Details
Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/user-agents.
## [index.d.ts](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/user-agents/index.d.ts)
````ts
declare class UserAgent {
    /**
     * The representation of a user-agents object.
     * @param filters <Array, Function, Object, RegExp, or String> - A set of filters to apply to the generated user agents
     */
    constructor(filters?: Filter | Filter[]);

    /**
     * Casts the UserAgent instance to a string which corresponds to the user agent header. Equivalent to accessing the userAgent.userAgent property.
     */
    toString(): string;

    /**
     * Generates a new UserAgent instance using the same filters that were used to construct userAgent
     */
    random(): UserAgent;

    /**
     * Get a fingerprint for the UserAgent instance
     */
    data: Data;
    /**
     *  The value of data.appName
     */
    appName: string;
}

type Filter = Partial<Data> | RegExp | ((data: Data) => boolean) | string;

interface Data {
    /**
     *  The value of navigator.appName
     */
    appName: string;
    /**
     *  The value of navigator.connection
     */
    connection?: Connection | undefined;
    /**
     *  The value of navigator.cpuClass
     */
    cpuClass?: string | undefined;
    /**
     * One of desktop, mobile, or tablet depending on the type of device
     */
    deviceCategory?: string | undefined;
    /**
     *  The value of navigator.oscpu
     */
    oscpu?: string | undefined;
    /**
     * The value of navigator.platform
     */
    platform: string;
    /**
     * The value of navigator.plugins.length
     */
    pluginsLength: number;
    /**
     *  The value of screen.height
     */
    screenHeight: number;
    /**
     * The value of screen.width
     */
    screenWidth: number;
    /**
     * The value of navigator.vendor
     */
    vendor: string;
    /**
     * The value of navigator.userAgent
     */
    userAgent: string;
    /**
     * The value of window.innerHeight
     */
    viewportHeight: number;
    /**
     * The value of window.innerWidth
     */
    viewportWidth: number;
}

interface Connection {
    downlink?: number | undefined;
    downlinkMax?: any;
    effectiveType?: string | undefined;
    rtt?: number | undefined;
    type?: string | undefined;
}

export = UserAgent;

````

### Additional Details
 * Last updated: Tue, 07 Nov 2023 15:11:36 GMT
 * Dependencies: none

# Credits
These definitions were written by [Nick Chursin](https://github.com/unickq), and [Jan Peer Stöcklmair](https://github.com/JPeer264).

---
_Source: https://npm.io/package/@types/user-agents · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._