arrayiffy-if-string^3.13.14

Put non-empty strings into arrays, turn empty-ones into empty arrays. Bypass everything else.

Install via npm

npm i arrayiffy-if-string

Consume via a require():

const { arrayiffy } = require("arrayiffy-if-string");

or as an ES Module:

import { arrayiffy } from "arrayiffy-if-string";

Install as a script, via CDN

Put this in your HTML:

<script src="https://cdn.jsdelivr.net/npm/arrayiffy-if-string/dist/arrayiffy-if-string.umd.js"></script>

Then, you’ll get a global variable arrayiffyIfString in your Global object and you consume it like this:

const { arrayiffy } = arrayiffyIfString;

Trivia

This program has 8 assertions in its unit tests. That's less than all unit test assertions' median (44) and less than geometric mean (72).

In monorepo, 7 other packages consume this package.

§ Quick Take

import { strict as assert } from "assert";
import { arrayiffy } from "arrayiffy-if-string";

assert.deepEqual(arrayiffy("aaa"), ["aaa"]);

assert.deepEqual(arrayiffy(""), []);

assert.equal(arrayiffy(true), true);

assert.equal(arrayiffy(), undefined);

⬆ back to top

§ Purpose

If it's a non-empty string, put it into an array and return it.
If it's empty string, return an empty array.
If it's anything else, just return it.

It's main purpose is to prepare the input argument options' objects.

Also, check out check-types-mini.

⬆ back to top

§ API

arrayiffy(something)

In other words, it's a function which takes one input argument.

⬆ back to top

§ Competition

Mr. Sorhus' arrify API is slightly different, it casts everything to array (null into empty array, for example). arrayiffy-if-string on other hand, wraps only strings into arrays, bypassing the rest (null into null, for example).

It depends what you need.

⬆ back to top