arrayiffy-if-string^3.11.38

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

Install globally, via npm

npm i arrayiffy-if-string

The default is exported, so instead of "arrayiffy" below, you can name the consumed function however you want.

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">

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

const arrayiffy = arrayiffyIfString;

This arrayiffy is your main function. See its API in the main section.

Trivia

This program has 11 assertions in its unit tests. That's less than all unit test assertions' median (52) and less than geometric mean (71).

In monorepo, 10 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