js-wrapper-lib

• eng: javascript helpers, wrappers for core functions
• ru: Библиотека удобных оберток для стандартных функций javascript

Usage | Использование

Add src/jswl.js to your html, export other way and call needle function like:

jswl.functionName();

-- подключите src/jswl.js на html странице или иным образом добавьте в проект и вызываейте нужную вам функцию, например (for example):

jswl.isEmpty(value);

Usage in npm

Example:

import jswl from 'js-wrapper-lib';

if (jswl.isEmpty(apiToken)) {....}

Сборка и другая работа с npm

Сборка для продакшена

npm run-script build

-- файлы (минифицированный и несжатый) будут выгружены в папку dist/.

Отладочная сборка

npm run-script watch

Релизная сборка

Запуск тестов, генерация документации, сборка:

npm run release

Тестирование

npm run test

Публикация очередной версии

npm publish

Документация

Для работы с документацией выполните:

npm run create-docs

Просмотр будет доступен в /docs/index.html

Описание функций

Общие

• isEmpty(value) -- функция максимально близкая к empty() из php.
• getPropIfObjectDefined(obj, propertyName, defaultValue = '') -- Если передан объект, то попытается отдать значение поля с именем propertyName иначе вернет defaultValue
• isObject(value) -- проверит, что значение определено (напр. не null) и что является объектом.

Массивы

• uniqueArray(arr) -- вернет только уникальные значения массива arr.
• inArray(value, array, strict) -- проверит, содержится ли элемент в массиве.
• removeAllElementsLike(arr, value) -- удалит все вхождения элемента из массива (вернет новый массив)
• isAnyInArray(needles, array) -- Проверит содержится ли хотя бы один элемент из первого массива во втором
• allNotEmpty(arr) -- роверит, что все элементы массива не пусты (в смысле вызова для каждого jswl.isEmpty())
• getArrElementByObjectProp(arr, propName, propValue) -- Вернет первый элемент из массива объектов, если указанное свойство этого объекта совпадает с указанным значением

Объекты

• getObjectPropBySubprop(obj, propName, propValue) -- Вернет первый элемент из объекта с полями-объектов, если указанное свойство одного очередного подобъекта этого объекта совпадает с указанным значением

CHANGELOG | История изменений

CHANGELOG.md

@TODO

• getPropByPath() -- добавить возможность искать не только, по точке но и по фигурным скобкам (чтобы проходить массив).
• Можно добавить функции isEmptyNotEmptyStr() и аналогично для нуля.
• Добавить функцию для фильтрации массива по указанному полю (можно по вложеному значению).