##
{{marker}} Features
▲
- [**Common JavaScript Utilities**](./list.html#tags-common). **ooi** provides some useful functions and classes to make some specific operations more reusable. Working with objects, arrays, collections, convertation, events, formatting, meta-data and types.
- [**Node.js Tools**](./list.html#tags-node). Some useful methods to simplify certain node.js operations.
- [**DOM Utilities & Tools**](./list.html#tags-dom). Get, create and modify DOM elements, working with DOM-events and so on.
- [**Polyfills**](./list.html#tags-polyfills). Contains some useful polyfills.
##
{{marker}} Installation
▲
**Installation as local package:**
```sh
npm i --save ooi;
```
**Using the Hole Library:**
```javascript
import ooi from 'ooi';
let arr = [1, 2, 3];
ooi.append(arr, 4, 5, 6);
[1, 2, 3, 4, 5, 6].forEach(num => {
console.log(num);
});
console.log(arr);
```
##
{{marker}}Import ooi-modules by `.ooi` text file
▲
**File `util.ooi`:**
```txt
each
extend
flatten
class-meta
plural
isArray: $isarray
sse: ./util/sse.js
```
**Install plugin `esbuild-import-plugin`:**
```sh
npm i --save esbuild-import-plugin;
```
**Plug it:**
```js
const importPlugin = require('esbuild-import-plugin');
esbuild
.build({
entryPoints: ['./src/index.js'],
bundle: true,
outfile: './dist/app/app.js',
loader: {
'.js': 'jsx'
},
sourcemap: true,
target: ['chrome58', 'firefox57', 'safari11', 'edge16'],
define: {
'process.env.NODE_ENV': '"development"'
},
plugins: [
// Here!
importPlugin
]
})
.then(() => console.log('Builded!'))
.catch(err => console.log(err));
```
**Now you can import file `util.ooi` from esbuild module:**
```js
import util from './util.ooi';
util.each([1, 2, 3], (n, i) => console.log(n, i));
```
##
{{marker}} Documentation
▲
Explore Full Utils List
**Sections**:
- [Arrays](./list.html#section-arrays)
- [Collections](./list.html#section-collections)
- [Convert](./list.html#section-convert)
- [Events](./list.html#section-events)
- [Format](./list.html#section-format)
- [Meta](./list.html#section-meta)
- [Objects](./list.html#section-objects)
- [Util](./list.html#section-util)
##
{{marker}} CLI
▲
**Install ooi as CLI:**
```bash
sudo npm install --global ooi;
```
**Compile library for client:**
```sh
ooi compile
-s objects collections
-t fn objects
-min
-o assets/js/lib/ooi.min.js;
```
**Pack ooi as JS-module:**
```sh
cli pack
-s objects collections
-t fn objects
-o src/lib/ooi.js
```
##
{{marker}} Testing
▲
**Test all utilities:**
```sh
npm test;
```
