@return-continue/is-empty-value

A lightweight TypeScript/JavaScript utility for checking whether a value is empty.

Features

• ✅ Works with JavaScript and TypeScript
• ✅ Zero runtime dependencies
• ✅ Lightweight and fast
• ✅ Includes TypeScript type definitions
• ✅ Supports strings, arrays, objects, Map, Set, null, and undefined

Installation

Using npm:

npm install @return-continue/is-empty-value

Using Yarn:

yarn add @return-continue/is-empty-value

Using pnpm:

pnpm add @return-continue/is-empty-value

Usage

TypeScript

import { isEmptyValue } from "@return-continue/is-empty-value";

console.log(isEmptyValue(""));            // true
console.log(isEmptyValue("   "));         // true
console.log(isEmptyValue([]));            // true
console.log(isEmptyValue({}));            // true
console.log(isEmptyValue(new Map()));     // true
console.log(isEmptyValue(new Set()));     // true
console.log(isEmptyValue(null));          // true
console.log(isEmptyValue(undefined));     // true

console.log(isEmptyValue("Hello"));       // false
console.log(isEmptyValue([1, 2]));        // false
console.log(isEmptyValue({ id: 1 }));     // false
console.log(isEmptyValue(new Map([[1, "A"]]))); // false
console.log(isEmptyValue(new Set([1])));  // false
console.log(isEmptyValue(0));             // false
console.log(isEmptyValue(false));         // false

JavaScript (ES Modules)

import { isEmptyValue } from "@return-continue/is-empty-value";

console.log(isEmptyValue([]));

JavaScript (CommonJS)

const { isEmptyValue } = require("@return-continue/is-empty-value");

console.log(isEmptyValue({}));

API

isEmptyValue(value): boolean

Returns true if the provided value is considered empty.

Returns true

• null
• undefined
• Empty string ("")
• Whitespace-only string (" ")
• Empty array ([])
• Empty object ({})
• Empty Map
• Empty Set

Returns false

• Non-empty strings
• Non-empty arrays
• Objects with one or more own enumerable properties
• Non-empty Map
• Non-empty Set
• Numbers
• Booleans
• Functions

Examples

isEmptyValue("");                     // true
isEmptyValue("   ");                  // true
isEmptyValue(null);                   // true
isEmptyValue(undefined);              // true
isEmptyValue([]);                     // true
isEmptyValue({});                     // true
isEmptyValue(new Map());              // true
isEmptyValue(new Set());              // true

isEmptyValue("OpenAI");               // false
isEmptyValue([1, 2]);                 // false
isEmptyValue({ id: 1 });              // false
isEmptyValue(new Map([[1, "A"]]));    // false
isEmptyValue(new Set([1]));           // false
isEmptyValue(0);                      // false
isEmptyValue(false);                  // false

TypeScript Support

This package is written in TypeScript and includes type definitions out of the box. No additional configuration is required.

License

MIT