it-for-free/js-wrapper-lib

核心功能的javascript辅助包装器

v0.0.2 2019-01-22 15:48 UTC

This package is auto-updated.

Last update: 2024-09-22 15:26:20 UTC


README

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

用法 | 使用

src/jswl.js 添加到您的 html 中,以其他方式导出,并调用 needle 函数,例如

jswl.functionName();

-- 在 html 页面上连接 src/jswl.js 或以其他方式将其添加到项目中,然后调用所需的函数,例如 (例如)

jswl.isEmpty(value);

在 npm 中的用法

示例

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) -- 与 php 中的 empty() 功能最接近的函数。
  • 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() 和类似功能用于零。
  • 添加一个用于按指定字段过滤数组的函数(可以是嵌套值)。