Non puoi selezionare più di 25 argomenti Gli argomenti devono iniziare con una lettera o un numero, possono includere trattini ('-') e possono essere lunghi fino a 35 caratteri.

README.md 1.7 KiB

3 anni fa
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. # value-equal [![Travis][build-badge]][build] [![npm package][npm-badge]][npm]
  2. [build-badge]: https://img.shields.io/travis/mjackson/value-equal/master.svg?style=flat-square
  3. [build]: https://travis-ci.org/mjackson/value-equal
  4. [npm-badge]: https://img.shields.io/npm/v/value-equal.svg?style=flat-square
  5. [npm]: https://www.npmjs.org/package/value-equal
  6. [`value-equal`](https://www.npmjs.com/package/value-equal) determines if two JavaScript values are equal using [`Object.prototype.valueOf`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/valueOf).
  7. In many instances when I'm checking for object equality, what I really want to know is if their **values** are equal. This is good for:
  8. - Stuff you keep in `localStorage`
  9. - `window.history.state` values
  10. - Query strings
  11. ## Installation
  12. Using [npm](https://www.npmjs.com/):
  13. $ npm install --save value-equal
  14. Then with a module bundler like [webpack](https://webpack.github.io/), use as you would anything else:
  15. ```js
  16. // using ES6 modules
  17. import valueEqual from 'value-equal';
  18. // using CommonJS modules
  19. var valueEqual = require('value-equal');
  20. ```
  21. The UMD build is also available on [unpkg](https://unpkg.com):
  22. ```html
  23. <script src="https://unpkg.com/value-equal"></script>
  24. ```
  25. You can find the library on `window.valueEqual`.
  26. ## Usage
  27. ```js
  28. valueEqual(1, 1); // true
  29. valueEqual('asdf', 'asdf'); // true
  30. valueEqual('asdf', new String('asdf')); // true
  31. valueEqual(true, true); // true
  32. valueEqual(true, false); // false
  33. valueEqual({ a: 'a' }, { a: 'a' }); // true
  34. valueEqual({ a: 'a' }, { a: 'b' }); // false
  35. valueEqual([1, 2, 3], [1, 2, 3]); // true
  36. valueEqual([1, 2, 3], [2, 3, 4]); // false
  37. ```
  38. That's it. Enjoy!