npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

upcast

v4.0.0

Published

Upcast is a low-level JavaScript type checking and casting library

Downloads

56,871

Readme

Upcast Build Status Coverage Status FOSSA Status

Upcast is a low-level JavaScript type checking and casting library. Upcast simplifies type-checking and converts between types in a more sensible and predictable way than using plain ol' JavaScript.

Getting Started

You can use Upcast on the server side with Node.js and yarn/npm:

$ yarn add upcast
$ npm install upcast

Usage

Upcast exposes three simple functions:

  • type: get the type of an object
  • is: check whether an object is of a given type
  • to: convert an object to a specific type

upcast.type

Get the type of an object. This accepts a single argument: val: (mixed) The object to get the type of.

Types in Upcast are different to typeof in what is reported for arrays and null. See the example below:

upcast.type([]); // 'array'
upcast.type(true); // 'boolean'
upcast.type(function () {}); // 'function'
upcast.type(null); // 'null'
upcast.type(123); // 'number'
upcast.type({}); // 'object'
upcast.type('foo'); // 'string'
upcast.type(undefined); // 'undefined'

upcast.is

Check whether an object is of a given type. This accepts two arguments: val: (mixed) The object to check the type of. type: (string) The type to check for. One of array, boolean, function, null, number, object, string or undefined.

This function follows the same rules outlined in upcast.type and allows you to use type aliases.

upcast.is('foo', 'string'); // true
upcast.is(123, 'string'); // false

upcast.is([], 'array'); // true
upcast.is([], 'object'); // false

upcast.is(null, 'null'); // true
upcast.is(null, 'object'); // false

upcast.to

Convert an object to a specific type. This accepts two arguments: val: (mixed) The object to convert. type: (string) The type to convert to. One of array, boolean, function, null, number, object, string or undefined.

The way types are converted aims to be sensible and allow easy switching back-and-forth of common types. For example, switching between strings and arrays is quite fluid:

upcast.to('foo', 'array'); // ['f', 'o', 'o']
upcast.to(['f', 'o', 'o'], 'string'); // 'foo'

You can use type aliases with this function. The examples below illustrate the way types are converted.

Converting to an array

Converting to an array from a boolean, function, number or object simply wraps the value in an array:

upcast.to(123, 'array'); // [123]

Strings are handled differently, an array is returned with each character in the string as an item:

upcast.to('foo', 'array'); // ['f', 'o', 'o']

Null and undefined are converted to an empty array:

upcast.to(null, 'array'); // []

Converting to a boolean

Boolean conversion simply converts to true or false based on whether the value is truthy or not. The only case where this doesn't follow JavaScript's standard behaviour is with empty arrays which are converted to false:

upcast.to([1, 2, 3], 'boolean') // true
upcast.to([], 'boolean') // false

Converting to a function

When converting to a function, the original value is simply wrapped in a new function. This function returns the original value:

upcast.to('foo', 'function'); // function () { return 'foo'; }

Converting to null

As expected, converting to null will always return null:

upcast.to('foo', 'null'); // null

Converting to a number

Converting to a number from a boolean, function, null or object simply calls Number with the original value as an argument, returning the expected value:

upcast.to('true', 'number'); // 1

Arrays and strings are handled differently, an array is joined to create a string, then evaluated with parseInt; strings are simply evaluated with parseInt:

upcast.to([1, 2, 3], 'number'); // 123
upcast.to('123', 'number'); // 123
upcast.to('foo', 'number'); // 0

Undefined is converted to 0 rather than NaN:

upcast.to(undefined, 'number'); // 0

Converting to an object

Converting to an object simply calls Object with the value as a first argument. The following are equivalent:

upcast.to('foo', 'object');
Object('foo');

Converting to a string

Converting to a string from a boolean, function, number or object simply returns the value added to an empty string, using JavaScript's default type conversion:

upcast.to(true, 'string'); // 'true'
upcast.to(123, 'string'); // '123'

Arrays are handled differently, they are joined with an empty string:

upcast.to(['f', 'o', 'o'], 'string'); // 'foo'

Null and undefined are converted to an empty string rather than 'null' and 'undefined':

upcast.to(null, 'string'); // ''

Converting to undefined

As expected, converting to undefined will always return undefined:

upcast.to('foo', 'undefined'); // undefined

Type aliases

The is and to functions allow you to use aliases to certain core types. The following are equivalent:

upcast.is([], 'array');
upcast.is([], 'arr');
upcast.is([], 'a');

The aliases available by default are:

  • array: arr, a
  • boolean: bool, b
  • function: fn, f
  • number: num, n
  • object: obj, o
  • string: str, s

Development

To work on Upcast you'll need to clone the repo and it's install dependencies with git clone https://github.com/OmgImalexis/upcast && cd upcast && yarn install.

Once you're set up, you can run the following commands:

$ yarn lint           # Run xo to lint all js files
$ yarn test           # Run unit tests with ava
$ yarn test-coverage  # Run unit tests and coverage report with ava + nyc

License

Upcast is licensed under the MIT license.

License

FOSSA Status