Performs a SameValueZero comparison between two values to decide if they are equivalent. Part of Lodash Lang since 4.0.0 (stable — not deprecated). Note: same rule as Map / Set keys — NaN equals NaN, and +0 equals -0.
Pass the value you want to inspect or convert. Read the return type carefully before you use the result.
Call _.eq. Start with this line.
_.eq(value, other)| Call | What it does |
|---|---|
_.eq(value, other) | Primary signature. |
_.eq(value) | Check, compare, clone, or convert a value. |
Prefer import eq from "lodash/eq" when you want a smaller bundle.
_.eq(value, other)| Parameter | Description |
|---|---|
| value | Required. First value to compare |
| other | Required. Second value to compare |
| Return Value | Description |
|---|---|
| * | true if equivalent, else false |
Objects match only when they are the same reference.
var object = { a: 1 };
var other = { a: 1 };
console.log(_.eq(object, object)); // true
console.log(_.eq(object, other)); // falseobject compared to itself → true.other has the same shape but is a new object.false._.isEqual.Object("a")A string primitive is not the same as a String object wrapper.
console.log(_.eq("a", "a")); // true
console.log(_.eq("a", Object("a"))); // false"a" strings match → true.Object("a") is an object, not a primitive string.false.NaN Equals NaNThe main reason to prefer _.eq over bare ===.
console.log(NaN === NaN); // false
console.log(_.eq(NaN, NaN)); // trueNaN !== NaN.NaN appears.+0 and -0 Are EqualUnlike Object.is, signed zeros match under SameValueZero.
console.log(_.eq(0, -0)); // true
console.log(Object.is(0, -0)); // false
console.log(0 === -0); // true0 and -0 match.Object.is, not _.eq.eq vs isEqualReference check versus deep content check.
var a = { x: 1 };
var b = { x: 1 };
console.log(_.eq(a, b)); // false
console.log(_.isEqual(a, b)); // truefalse.true.eq is O(1); isEqual grows with structure size.eq; deep trees → isEqual._.eq is a Lodash 4.x Lang helper (since 4.0.0). It runs anywhere Lodash runs — modern browsers (via CDN or bundle) and Node.js / Bun / Deno with npm install lodash. Native engines expose related ideas via ===, Object.is, and SameValueZero in Map/Set, but not this helper by name.
Available in [email protected] full builds and the lodash/eq modular import. Works in evergreen browsers and current Node LTS when Lodash is installed.
Bottom line: Safe for production once Lodash is on the page or in your bundle. Prefer import eq from "lodash/eq" for smaller builds. Not a native browser API — load Lodash first.
Check whether one value is strictly greater than another.
10 people found this page helpful