Начало работы

Эта документация описывает API 1.0.0-beta. Установите beta-версию, чтобы использовать фабрику и расширения.

npm

npm install undevice@beta

pnpm

pnpm add undevice@beta

yarn

yarn add undevice@beta

bun

bun add undevice@beta

Первый вызов

Создайте детектор один раз, затем передавайте заголовки каждого входящего запроса в detect():

import { undevice } from "undevice";

const { detect } = undevice();
const device = detect({ headers: request.headers });

device.isMobile;
device.isTablet;
device.isDesktop;

undevice() возвращает замороженный объект с методом detect. Каждый вызов detect() возвращает новый замороженный UndeviceResult с флагами.

Библиотека не изменяет входные данные и не обращается неявно к контексту запроса или глобальным объектам браузера.

User-Agent

В браузере передайте navigator.userAgent:

import { undevice } from "undevice";

const { detect } = undevice();
const device = detect({ userAgent: navigator.userAgent });

Чтобы переопределить User-Agent:

const device = detect({
  headers: request.headers,
  userAgent: customUserAgent,
});

При SSR используйте на клиенте результат, полученный на сервере, чтобы избежать расхождений при гидратации.