isBlank

Проверяет, является ли строка пустой или содержит только пробельные символы.

isBlank

Сигнатура

function isBlank(str: string | null | undefined): boolean

Параметры

• str — значение, которое нужно проверить.

Возвращает

true, если строка пустая или состоит только из пробелов/переводов строки/табов, иначе false.

Примеры

import { isBlank } from 'strio'

// Пустая строка
isBlank('')
// true

// Только пробелы / whitespace
isBlank('   ')
// true

isBlank('\n\t\r')
// true

isBlank('  \n  \t  ')
// true

// null и undefined
isBlank(null)
// true

isBlank(undefined)
// true

// Непустые строки
isBlank('hello')
// false

isBlank('  hello  ')
// false (есть непробельные символы)

Практические кейсы

import { isBlank, isEmpty } from 'strio'

// Более "строгая" required-валидация (игнорируем пробелы)
function validateInput(value: string | null | undefined): boolean {
  return !isBlank(value)
}

// Проверка: строка состоит только из пробелов (а не совсем пустая)
function isOnlyWhitespace(value: string | null | undefined): boolean {
  return !isEmpty(value) && isBlank(value)
}

// Очистка значения: превращаем "пустые" строки в null
function sanitize(input: string | null | undefined): string | null {
  return isBlank(input) ? null : input!.trim()
}

Связанные функции

• isEmpty — проверка на пустое значение
• trim — обрезка пробельных символов по краям
• collapseWhitespace — схлопывание повторяющихся пробелов

Смотрите также

• Руководство по валидации строк
• Обзор API