firest commit

2026-02-21 22:48:40 +08:00
commit 55e8053e07
1034 changed files with 99049 additions and 0 deletions
@@ -0,0 +1,81 @@
+[![view on npm](https://img.shields.io/npm/v/array-back.svg)](https://www.npmjs.org/package/array-back)
+[![npm module downloads](https://img.shields.io/npm/dt/array-back.svg)](https://www.npmjs.org/package/array-back)
+[![Build Status](https://travis-ci.org/75lb/array-back.svg?branch=master)](https://travis-ci.org/75lb/array-back)
+[![Coverage Status](https://coveralls.io/repos/github/75lb/array-back/badge.svg?branch=master)](https://coveralls.io/github/75lb/array-back?branch=master)
+[![Dependency Status](https://badgen.net/david/dep/75lb/array-back)](https://david-dm.org/75lb/array-back)
+[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](https://github.com/feross/standard)
+
+<a name="module_array-back"></a>
+
+## array-back
+Takes any input and guarantees an array back.
+
+- Converts array-like objects (e.g. `arguments`, `Set`) to a real array.
+- Converts `undefined` to an empty array.
+- Converts any another other, singular value (including `null`, objects and iterables other than `Set`) into an array containing that value.
+- Ignores input which is already an array.
+
+**Example**  
+```js
+> const arrayify = require('array-back')
+
+> arrayify(undefined)
+[]
+
+> arrayify(null)
+[ null ]
+
+> arrayify(0)
+[ 0 ]
+
+> arrayify([ 1, 2 ])
+[ 1, 2 ]
+
+> arrayify(new Set([ 1, 2 ]))
+[ 1, 2 ]
+
+> function f(){ return arrayify(arguments); }
+> f(1,2,3)
+[ 1, 2, 3 ]
+```
+<a name="exp_module_array-back--arrayify"></a>
+
+### arrayify(input) ⇒ <code>Array</code> ⏏
+**Kind**: Exported function  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| input | <code>\*</code> | The input value to convert to an array |
+
+
+### Load anywhere
+
+This library is compatible with Node.js, the Web and any style of module loader. It can be loaded anywhere, natively without transpilation.
+
+Node.js:
+
+```js
+const arrayify = require('array-back')
+```
+
+Within Node.js with ECMAScript Module support enabled:
+
+```js
+import arrayify from 'array-back'
+```
+
+Within an modern browser ECMAScript Module:
+
+```js
+import arrayify from './node_modules/array-back/index.mjs'
+```
+
+Old browser (adds `window.arrayBack`):
+
+```html
+<script nomodule src="./node_modules/array-back/dist/index.js"></script>
+```
+
+* * *
+
+&copy; 2015-19 Lloyd Brookes \<75pound@gmail.com\>. Documented by [jsdoc-to-markdown](https://github.com/75lb/jsdoc-to-markdown).