# isbot-fast

> JavaScript module detecting bots/crawlers/spiders via user-agent

Latest version **1.2.0** (published 2019-10-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install isbot-fast
pnpm add isbot-fast
yarn add isbot-fast
bun add isbot-fast
```

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.0 |
| Published | 2019-10-30 |
| First published | 2019-04-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=6.0.0 |
| Dependencies | 0 |
| Unpacked size | 5.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 11 |
| Author | mahovich |
| Maintainers | mahovich |
| Keywords | bot, spider, robot, crawler, useragent, user-agent, detector, detect, detection, is-bot, isbot, bot-detection, botdetection, detect-bot, detectbot, bot-detect, botdetect, is-spider, isspider, spider-detection, spiderdetection, detect-spider, detectspider, spider-detect, spiderdetect, is-robot, isrobot, robot-detection, robotdetection, detect-robot, detectrobot, robot-detect, robotdetect, is-crawler, iscrawler, crawler-detection, crawlerdetection, detect-crawler, detectcrawler, crawler-detect, crawlerdetect |

## Links

- npm: https://www.npmjs.com/package/isbot-fast
- Repository: https://github.com/mahovich/isbot-fast
- Issues: https://github.com/mahovich/isbot-fast/issues
- npm.io page: https://npm.io/package/isbot-fast

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 1.2.0 (latest) — 2019-10-30
- 1.1.0 — 2019-10-30
- 1.0.1 — 2019-10-22
- 1.0.0 — 2019-04-08

## README

# isbot-fast &middot; [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/mahovich/isbot-fast/blob/master/LICENSE) [![npm version](https://img.shields.io/npm/v/isbot-fast.svg?style=flat)](https://www.npmjs.com/package/isbot-fast)

The `isbot-fast` package is needed to quickly identify most bots/crawlers/spiders using a user-agent. It runs more than 10 times faster than the `isbot` package.

In addition to the search bots, `isbot-fast` identifies:
* bots of social networks and instant messengers
* preview bots receiving meta-information about the page
* some scanners and monitoring
* content downloaders

Note: the purpose of the package is not to determine absolutely all bots, since this will significantly slow down the speed of work. `isbot-fast` probably determines 99.5% of all requests sent by bots at the moment. If you want to identify even more existing bots, then pay attention to the `isbot` package.

The result of the function is a boolean value.

## Installation

```sh
npm install isbot-fast --save
```

## Usage

```js
const isBot = require('isbot-fast');

isBot('Googlebot/2.1 (+http://www.google.com/bot.html)');
// true

isBot('Opera/9.80 (Windows NT 6.0) Presto/2.12.388 Version/12.14');
// false
```

## Extending

If you want to maintain performance and exclude some bots that bother you, then add these bots to the additional exclusion list as shown in the example below.

```js
const isBot = require('isbot-fast');

isBot('W3C_Validator/1.3');
// false

isBot.extend(['validator', 'image']);

isBot('W3C_Validator/1.3');
// true
```

## Use case

```js
const isBot = require('isbot-fast');
const ua = req.headers['user-agent'] || '';

if (isBot(ua)) {
  // Provide static page for spiders when you have a single page app
} else {
  // Making cookies
}
```

## License

`isbot-fast` is [MIT licensed](https://github.com/mahovich/isbot-fast/blob/master/LICENSE).

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