# nuxtjs-device

> User device information for Nuxt.js

Latest version **0.3.1** (published 2021-11-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install nuxtjs-device
pnpm add nuxtjs-device
yarn add nuxtjs-device
bun add nuxtjs-device
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.3.1 |
| Published | 2021-11-14 |
| First published | 2020-07-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 10.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 4 |
| Maintainers | arshen |
| Keywords | nuxtjs, nuxt |

## Links

- npm: https://www.npmjs.com/package/nuxtjs-device
- Repository: https://github.com/xtoolkit/nuxtjs-device
- Homepage: https://github.com/xtoolkit/nuxtjs-device#readme
- Issues: https://github.com/xtoolkit/nuxtjs-device/issues
- npm.io page: https://npm.io/package/nuxtjs-device

## Dependencies (2)

- [bowser](https://npm.io/package/bowser.md) ^2.10.0
- [@nuxtjs/universal-storage](https://npm.io/package/@nuxtjs/universal-storage.md) ^0.5.5

## Recent versions

- 0.3.1 (latest) — 2021-11-14
- 0.3.0 — 2021-08-29
- 0.2.1 — 2021-08-29
- 0.2.0 — 2021-02-24
- 0.1.1 — 2020-10-15
- 0.1.0 — 2020-07-16
- 0.0.4 — 2020-07-16
- 0.0.3 — 2020-07-16
- 0.0.2 — 2020-07-16
- 0.0.1 — 2020-07-12

## README

# Nuxtjs User Device information [![npm (scoped with tag)](https://img.shields.io/npm/v/nuxtjs-device/latest.svg?style=flat-square)](https://npmjs.com/package/nuxtjs-device)

> user Device information for Nuxt.js based on [bowser](https://npmjs.com/bowser)

[📖 **Release Notes**](./CHANGELOG.md)

## Setup

- Add `nuxtjs-device` dependency using npm to your project

```sh
npm install nuxtjs-device --save
```

- Add `nuxtjs-device` to the `modules` section of your `nuxt.config.js` file

```js
{
  modules: ['nuxtjs-device'];
}
```

## Usage

`nuxtjs-device` detect all of user device/browser information. You can use this module with \$device insntant.

```js
console.log(this.$device.db)

// output
{
  browser: {
    name: "Firefox",
    version: "78.0",
    touch: false,
    mouse: false,
    ip: "127.0.0.1"
  },
  os: {
    name: "Windows",
    version: "NT 10.0",
    versionName: "10"
  },
  platform: {
    type: "desktop",
    vendor: "",
    model: "",
    pwa: false
  },
  engine: {
    name: "Gecko",
    version: "20100101"
  }
}
```

### Filter

You could want to filter some particular browsers to provide any special support for them or make any workarounds. It could look like this:

```js
const isValidBrowser = this.$device.filter({
  // declare browsers per OS
  windows: {
    'internet explorer': '>10'
  },
  macos: {
    safari: '>10.1'
  },

  // per platform (mobile, desktop or tablet)
  mobile: {
    safari: '>=9',
    'android browser': '>3.10'
  },

  // or in general
  chrome: '~20.1.1432',
  firefox: '>31',
  opera: '>=22',

  // also supports equality operator
  chrome: '=20.1.1432', // will match particular build only

  // and loose-equality operator
  chrome: '~20', // will match any 20.* sub-version
  chrome: '~20.1' // will match any 20.1.* sub-version (20.1.19 as well as 20.1.12.42-alpha.1)
});
```

## Development

- Clone this repository
- Install dependencies using `yarn install` or `npm install`
- Start development server using `yarn run dev` or `npm run dev`
- Point your browser to `http://localhost:3000`

## License

[MIT License](./LICENSE)

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