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 | История изменений
@TODO
-
getPropByPath()
-- добавить возможность искать не только, по точке но и по фигурным скобкам (чтобы проходить массив). - Можно добавить функции
isEmptyNotEmptyStr()
и аналогично для нуля. - Добавить функцию для фильтрации массива по указанному полю (можно по вложеному значению).