What is arrify?
The arrify npm package is designed to convert a value to an array. If the input value is already an array, it is returned as is. If the input is null or undefined, an empty array is returned. For any other input, the value is placed as a single item within an array. This package is particularly useful for ensuring that data is in array form without having to write repetitive checks and conversions throughout your code.
What are arrify's main functionalities?
Converting non-array values to an array
This feature demonstrates how to convert various types of non-array values (like strings or numbers) into an array containing that value.
const arrify = require('arrify');
console.log(arrify('hello')); // ['hello']
console.log(arrify(5)); // [5]
Handling null or undefined values
This feature shows how arrify converts null or undefined inputs into an empty array, which is useful for avoiding errors when working with potentially null or undefined data.
const arrify = require('arrify');
console.log(arrify(null)); // []
console.log(arrify(undefined)); // []
Preserving array inputs
This feature illustrates that arrify will return the input as is if it's already an array, ensuring that array inputs are not modified or wrapped in another array.
const arrify = require('arrify');
console.log(arrify(['already', 'an', 'array'])); // ['already', 'an', 'array']
Other packages similar to arrify
to-array
Similar to arrify, the to-array package converts various types of values into arrays. However, it might handle certain edge cases differently or offer additional features for converting objects into arrays.
arrayify
The arrayify package offers functionality similar to arrify, aiming to ensure that inputs are returned as arrays. The differences may lie in specific implementation details or additional options for handling complex data types.
arrify
Convert a value to an array
Install
$ npm install arrify
Usage
const arrify = require('arrify');
arrify('🦄');
arrify(['🦄']);
arrify(new Set(['🦄']));
arrify(null);
arrify(undefined);
Supplying null
or undefined
results in an empty array.
License
MIT © Sindre Sorhus