小なりイコール演算子 (<=)

試してみましょう

console.log(5 <= 3);
// 予想される結果: false
console.log(3 <= 3);
// 予想される結果: true
// Compare bigint to number
console.log(3n <= 5);
// 予想される結果: true
console.log("aa" <= "ab");
// 予想される結果: true

構文

x <= y;

解説

オペランドは、小なり演算子と同じアルゴリズムを使用して、オペランドを入れ替えて比較され、結果が反転されます。 x <= y は通常 !(y < x) と同等ですが、 x <= y と x > y の両方が false となる 2 つの例外があります。

• 一方のオペランドが長整数に変換される一方、もう一方が長整数値に変換できない（BigInt() に渡すと構文エラーを発生する）文字列に変換される場合。
• オペランドの一方が NaN に変換される場合。（例えば、数値に変換できない文字列や undefined など。）

さらに、x <= y は x を y より前にプリミティブ型に型変換し、y < x は y を x より前にプリミティブ型に型変換します。型変換には副作用を 持つ可能性が あるため、オペランドの順序が重要になる場合があります。

x <= y は、一般的に x > y || x == y と同等ですが、次のいくつかの例外があります。

• x または y のいずれかが null で、もう一方が null ではなく、数値型への変換によって 0 になる値（0、0n、false、""、"0"、new Date(0) など）の場合、 x <= y は true と評価され、 x < y || x == y は false と評価されます。
• x または y の一方が undefined で、もう一方が null または undefined である場合、 x <= y は false となる一方、x == y は true となります。
• x と y が同じオブジェクトであり、小なり演算の最初の段階の後で NaN になる場合（new Date(NaN) など）、 x <= y は false となる一方、 x == y は true となります。
• x と y が異なるオブジェクトであり、小なり演算の最初の段階の後、同じ値になる場合、 x <= y は true となる一方、 x < y || x == y は false となります。

例

文字列と文字列の比較

"a" <= "b"; // true
"a" <= "a"; // true
"a" <= "3"; // false

文字列と数値の比較

"5" <= 3; // false
"3" <= 3; // true
"3" <= 5; // true
"hello" <= 5; // false
5 <= "hello"; // false

数値と数値の比較

5 <= 3; // false
3 <= 3; // true
3 <= 5; // true

数値と長整数の比較

5n <= 3; // false
3 <= 3n; // true
3 <= 5n; // true

論理値、null、undefined、NaN の比較

true <= false; // false
true <= true; // true
false <= true; // true
true <= 0; // false
true <= 1; // true
null <= 0; // true
1 <= null; // false
undefined <= 3; // false
3 <= undefined; // false
3 <= NaN; // false
NaN <= 3; // false

仕様書

ブラウザーの互換性

関連情報

• 大なり演算子 (>)
• 大なりイコール演算子 (>=)
• 小なり演算子 (<)