ES Type Detection

A modern utility library for ECMAScript type detection — built to be safe, testable, and extensible — zero dependencies, fully inspectable.

🎁 Why Use This Library?

• 📦 Zero dependencies, suitable for any JavaScript runtime.
• 🔢 Detection of basic built-in types and primitive vs boxed types detection.
• 🧠 Distinguishes function-types accurately — class vs. function vs. generator vs. async and much more.
• 🔥 Fine grained error-type detection.
• 🌊 Accurate "flow-type" detection — generators, thenables, promises.
• 🧩 Extensible, and comes with both type-identity detection and stable type-identity tagging/branding.
• 🧪 Fully tested with coverage reporting.
• 📘 Richly documented via TypeDoc.

📦 Installation

npm install @petsel/es-type-detection
Copy

🚀 Quick Usage

import { base, fn, flow, utility } from '@petsel/es-type-detection';

const { isFunction, isObject, isBoxedNumber, isNumberValue, isNumber } = base;
const { isConstructable, isClass, isGeneratorFunction, isNonAsyncArrow } = fn;
const { isAsyncGenerator, isPromise, doesMatchSafeThenable } = flow;
const { resolveType } = utility;

console.log(isClass(class X {})); // true
console.log(isFunction((_) => _)); // true
console.log(resolveType([])); // "Array"
Copy

📘 Documentation

• Project Website

• 📘 API Reference (HTML, TypeDoc)

• 📄 API Docs (Markdown Export)

• 📊 Test Coverage Report

🛡 License and Usage Notice

This project is licensed under the MIT License.

MIT © Peter Seliger

See LICENSE for details.

Additional Use Guidelines

Please read the TRADEMARK.md for rules regarding project name use, compatibility requirements, and monetization restrictions.

Project setup

• clone (or download)

  git clone git@github.com:petsel/es-type-detection.git
  Copy

• install

  npm ci
  Copy

Developer Note(s)

• Notes about the used TypeDoc setup
• Automated tests, coverage reports, and API docs are deployed on every push to dev.