isNonEmpty

Checks if a string is non-empty (has at least one character). null and undefined are considered empty and return false.

Whitespace-only strings are considered non-empty. Use isNonEmpty(value?.trim()) if you need to exclude blank strings.

Available since v2.0.3

Import

import { isNonEmpty } from '@helpers4/string';
// or, from the all-in-one package (same code, one install):
import { isNonEmpty } from 'helpers4/string';

Signature

isNonEmpty(value: string | null | undefined): value is string

Parameters

Parameter	Type	Description
value	string | null | undefined	The string to check

Returns

value is string — true if the string has at least one character; false for "", null, or undefined. Acts as a type guard: the if branch narrows string | null | undefined to string.

Examples

Check if a string has content

Returns true for any string with at least one character, including whitespace.

isNonEmpty('hello') // => true
isNonEmpty(' ')     // => true  (whitespace is content)
isNonEmpty('')      // => false

Exclude blank strings by trimming first

Compose with .trim() when whitespace-only strings should be treated as empty.

isNonEmpty('hello'.trim()) // => true
isNonEmpty('   '.trim())   // => false
isNonEmpty(''.trim())      // => false

Name conflict

A helper named isNonEmpty also exists in @helpers4/array, @helpers4/object. If you need both in the same file, rename at import with as:

import { isNonEmpty as isNonEmpty4string } from '@helpers4/string';
import { isNonEmpty as isNonEmpty4array } from '@helpers4/array';
import { isNonEmpty as isNonEmpty4object } from '@helpers4/object';

See Name Conflicts for the full resolution guide.

Source

View source on GitHub