Socket
Socket
Sign inDemoInstall

comparejs

Package Overview
Dependencies
2
Maintainers
5
Versions
30
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    comparejs

comparejs implements JavaScript's comparison operators the way you would expect them to be.


Version published
Weekly downloads
26K
increased by6.7%
Maintainers
5
Install size
57.9 kB
Created
Weekly downloads
 

Changelog

Source

4.0.14 (2021-08-16)

Bug Fixes

  • bump is-subset-of from 3.1.8 to 3.1.9 (#336) (55576b9)
  • bump path-parse from 1.0.6 to 1.0.7 (#335) (c8223c5)

Readme

Source

comparejs

comparejs implements JavaScript's comparison operators the way you would expect them to be.

Status

CategoryStatus
Versionnpm
DependenciesDavid
Dev dependenciesDavid
BuildGitHub Actions
LicenseGitHub

Installation

$ npm install comparejs

Quick Start

To use comparejs you need to reference it from your application by adding the following line:

const { compare } = require('comparejs');

If you use TypeScript, use the following code instead:

import { compare } from 'comparejs';

Features

  • Supports comparison of array, boolean, function, null, number, object, string and undefined.
  • Supports comparison of native data types and constructor-created data types, such as number and new Number().
  • Supports comparison of objects and arrays using deep-equal.
  • Supports comparison of objects and arrays with <, <=, > and >= by handling them as subsets.
  • Supports comparison of objects by structure.
  • Supports comparison with undefined correctly, as <= and >= are problematic in plain JavaScript.
  • Supports comparison in a perfectly type-safe way out-of-the-box.
  • Supports comparison by equality and identity, depending on what makes sense.

Basic usage

Now you are able to use the various comparison operators. All you need to do is access the compare object and use its functions:

Operator AliasDescription
equal(left, right)eq(left, right)equal
notEqual(left, right)ne(left, right)not equal
lessThan(left, right)lt(left, right)less than
lessThanOrEqual(left, right)lte(left, right)less than or equal
greaterThan(left, right)gt(left, right)greater than
greaterThanOrEqual(left, right)gte(left, right)greater than or equal
identity(left, right)id(left, right)identity

Please note that each comparison operator works on each combination of types and does what you would expect it to do.

Structure comparison operators

For objects, there are special operators that compare by structure. Among other things, they can be used to verify objects against interfaces:

OperatorAliasDescription
equalByStructure(left, right)eqs(left, right)equal by structure
notEqualByStructure(left, right)nes(left, right)not equal by structure
lessThanByStructure(left, right)lts(left, right)less than by structure
lessThanOrEqualByStructure(left, right)ltes(left, right)less than or equal by structure
greaterThanByStructure(left, right)gts(left, right)greater than by structure
greaterThanOrEqualByStructure(left, right)gtes(left, right)greater than or equal by structure

Please note that these operators only work for objects. For any other type, they return false.

Running quality assurance

To run quality assurance for this module use roboter:

$ npx roboter

Keywords

FAQs

Last updated on 16 Aug 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc