string-utils.js

[Исходный php-trim-plus]_

Полезные утилиты для работы со строками в JavaScript. Сохраняет все возможности исходного пакета php-trim-plus, а также расширяет поддержку типов данных Buffer, ArrayBuffer и TypedArray.

Основные предоставляемые функции:

• toSafeString
• isBufferObject, bufferToString
• trim, ltrim, rtrim
• isEmptyString, isEmptyStringOrWhitespace
• isString, isSymbol (из библиотеки lodash)

Инструкция по использованию

toSafeString

• нормализация Unicode
• преобразование массива в строку с помощью метода join
• извлечение символов из объекта типа Symbol
• преобразование функций в пустую строку
• преобразование объектов с попыткой вызова метода toString

toSafeString(value);

// При работе с массивом, второй параметр является разделителем
toSafeString(['a', 'b', 'c'], '/'); // 'a/b/c';

// При работе с буфером, второй параметр представляет собой кодировку
toSafeString(Buffer.from('hello'), 'base64');

trim

trim(str, charList, isPlus);
ltrim(str, charList, isPlus);
rtrim(str, charList, isPlus);
trim(' 开源中国 '); // '开源中国';
trim(' 红薯-- ', '-'); // '红薯';

str: string — строка для обработки
charList: string — список символов для удаления
isPlus: boolean — указывает, следует ли добавлять символы из списка charList к текущим пробелам, значение по умолчанию true, trim.Replace или trim.Plus### isEmptyString, isEmptyStringOrWhitespace

isEmptyString(value);

isEmptyString(null); // true
isEmptyString(undefined); // true
isEmptyString(''); // true
isEmptyString([]); // true (в текущей версии)
isEmptyString({}); // false

Проверяет, является ли строка пустой. В данном случае строка не обрабатывается методом trim. Для проверки того, что строка состоит только из пробелов, используйте isEmptyStringOrWhitespace.

isEmptyStringOrWhitespace(value);

isEmptyStringOrWhitespace(null); // true isEmptyStringOrWhitespace(undefined); // true isEmptyStringOrWhitespace(''); // true isEmptyStringOrWhitespace(' '); // true isEmptyStringOrWhitespace('\t'); // true isEmptyStringOrWhitespace('\n'); // true isEmptyStringOrWhitespace([]); // true // Обновленная версия isEmptyStringOrWhitespace({}); // false

Проверяет, является ли значение пустой строкой или строкой, содержащей только пробелы, путём применения метода `trim()` к значению `value`.

```js
isSymbol(value);

Проверяет, является ли значение объектом типа Symbol.