PHPackages                             it-for-free/js-wrapper-lib - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. it-for-free/js-wrapper-lib

ActiveLibrary[Utility & Helpers](/categories/utility)

it-for-free/js-wrapper-lib
==========================

javascript helpers wrappers for core functions

v0.0.2(7y ago)263MITJavaScript

Since Dec 14Pushed 5y ago1 watchersCompare

[ Source](https://github.com/it-for-free/js-wrapper-lib)[ Packagist](https://packagist.org/packages/it-for-free/js-wrapper-lib)[ Docs](http://fkn.ktu10.com/?q=iff-itforfree)[ RSS](/packages/it-for-free-js-wrapper-lib/feed)WikiDiscussions master Synced yesterday

READMEChangelog (1)DependenciesVersions (2)Used By (0)

js-wrapper-lib
==============

[](#js-wrapper-lib)

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

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

[](#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

[](#usage-in-npm)

Example:

```
import jswl from 'js-wrapper-lib';

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

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

[](#сборка-и-другая-работа-с-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--история-изменений)

[CHANGELOG.md](/CHANGELOG.md)

@TODO
-----

[](#todo)

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

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~39 days

Total

2

Last Release

2668d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/000ccb276eafa9e6159c0266a3fcf5457d445f58998551de595976fca7a3b2a5?d=identicon)[it-for-free](/maintainers/it-for-free)

---

Top Contributors

[![vedro-compota](https://avatars.githubusercontent.com/u/2771630?v=4)](https://github.com/vedro-compota "vedro-compota (79 commits)")[![NookieNoo](https://avatars.githubusercontent.com/u/52598716?v=4)](https://github.com/NookieNoo "NookieNoo (3 commits)")

---

Tags

javascriptJSlibrarywrapperlike phpis emptyin array

### Embed Badge

![Health badge](/badges/it-for-free-js-wrapper-lib/health.svg)

```
[![Health](https://phpackages.com/badges/it-for-free-js-wrapper-lib/health.svg)](https://phpackages.com/packages/it-for-free-js-wrapper-lib)
```

###  Alternatives

[matthiasmullie/minify

CSS & JavaScript minifier, in PHP. Removes whitespace, strips comments, combines files (incl. @import statements and small assets in CSS files), and optimizes/shortens a few common programming patterns.

2.0k30.5M336](/packages/matthiasmullie-minify)[desandro/masonry

Cascading grid layout library

16.7k424.4k1](/packages/desandro-masonry)[desandro/imagesloaded

JavaScript is all like \_You images done yet or what?\_

8.9k439.0k1](/packages/desandro-imagesloaded)[nostalgiaz/bootstrap-switch

Turn checkboxes and radio buttons into toggle switches.

5.0k362.3k4](/packages/nostalgiaz-bootstrap-switch)[stolz/assets

An ultra-simple-to-use assets management library

296519.2k8](/packages/stolz-assets)[tholu/php-packer

A PHP version of Packer, JavaScript obfuscation library originally created by Dean Edwards

137441.2k5](/packages/tholu-php-packer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)