パラメータ

value

安全な整数かどうかを判定する値。

戻り値

指定された値が安全な整数である場合は true、そうでない場合は false を返します。

基本的な使用法

以下のプログラムは、Number.isSafeInteger() の基本的な使用法を示しています。

// 整数値の確認
console.log(Number.isSafeInteger(3)); // true
console.log(Number.isSafeInteger(Math.pow(2, 53) - 1)); // true
console.log(Number.isSafeInteger(-Math.pow(2, 53) + 1)); // true
console.log(Number.isSafeInteger(Math.pow(2, 53))); // false

// 浮動小数点数の確認
console.log(Number.isSafeInteger(3.1)); // false
console.log(Number.isSafeInteger(3.0)); // true

// 非数値の確認
console.log(Number.isSafeInteger(NaN)); // false
console.log(Number.isSafeInteger(Infinity)); // false
console.log(Number.isSafeInteger('3')); // false
console.log(Number.isSafeInteger(null)); // false

このプログラムでは、様々な値に対して Number.isSafeInteger() メソッドを適用し、それらが安全な整数かどうかを確認しています。

Number.MAX_SAFE_INTEGER との関係

以下のプログラムは、Number.isSafeInteger() と Number.MAX_SAFE_INTEGER の関係を示しています。

// 安全な整数の上限
console.log(Number.MAX_SAFE_INTEGER); // 9007199254740991
console.log(Number.isSafeInteger(Number.MAX_SAFE_INTEGER)); // true

// 安全な整数の範囲を超える
console.log(Number.isSafeInteger(Number.MAX_SAFE_INTEGER + 1)); // false
console.log(Number.isSafeInteger(Number.MAX_SAFE_INTEGER + 2)); // false

// 安全でない整数の演算の問題
console.log(Number.MAX_SAFE_INTEGER + 1 === Number.MAX_SAFE_INTEGER + 2); // true (！) 異なる値なのに等しくなる

このプログラムでは、Number.MAX_SAFE_INTEGER までの整数は安全ですが、それを超えると安全ではなくなることを示しています。安全でない整数値を使用すると、等値比較などで予期せぬ結果が生じる可能性があります。

独自の isSafeInteger 実装

Number.isSafeInteger() メソッドが利用できない環境でも、同等の機能を実装できます。

// 独自の isSafeInteger 実装
function isSafeInteger(value) {
  return Number.isInteger(value) && 
         Math.abs(value) <= Number.MAX_SAFE_INTEGER;
}

// または ES6 未対応環境での polyfill
if (!Number.isSafeInteger) {
  Number.isSafeInteger = function(value) {
    return typeof value === 'number' && 
           Math.floor(value) === value &&
           Math.abs(value) <= 9007199254740991;
  };
}

// テスト
console.log(isSafeInteger(42)); // true
console.log(isSafeInteger(9007199254740992)); // false
console.log(isSafeInteger(3.5)); // false

このプログラムでは、Number.isSafeInteger() メソッドの独自実装と、古いブラウザ向けの polyfill の例を示しています。

安全な数値計算の実装

以下のプログラムは、数値計算の結果が安全な整数の範囲内にあるかどうかを確認する例を示しています。

// 安全な整数演算を行う関数
function safeAdd(a, b) {
  if (!Number.isSafeInteger(a) || !Number.isSafeInteger(b)) {
    throw new Error('入力値が安全な整数ではありません');
  }
  
  const result = a + b;
  
  if (!Number.isSafeInteger(result)) {
    throw new Error('計算結果が安全な整数の範囲を超えています');
  }
  
  return result;
}

// 使用例
try {
  console.log(safeAdd(10, 20)); // 30
  console.log(safeAdd(Number.MAX_SAFE_INTEGER, 1)); // エラー
} catch (e) {
  console.error(e.message); // "計算結果が安全な整数の範囲を超えています"
}

このプログラムでは、整数の加算を行う際に、入力値と計算結果が安全な整数の範囲内にあるかをチェックする関数の例を示しています。結果が安全な範囲を超える場合はエラーをスローします。

ID の安全性チェック

以下のプログラムは、データベースから取得した ID 値が安全な整数の範囲内にあるかどうかを確認する例を示しています。

// ID の安全性をチェックするユーティリティクラス
class IDValidator {
  constructor() {
    this.warningIssued = new Set();
  }
  
  // ID が安全かどうかをチェック
  validateID(id, source) {
    const idNum = Number(id);
    
    if (!Number.isSafeInteger(idNum)) {
      const key = <code>${source}-${id}</code>;
      
      // 同じ ID について警告を繰り返さない
      if (!this.warningIssued.has(key)) {
        console.warn(<code>警告: ${source} から取得した ID ${id} は安全な整数ではありません。文字列として扱ってください。</code>);
        this.warningIssued.add(key);
      }
      
      return false;
    }
    
    return true;
  }
  
  // 安全に ID を処理する
  processID(id, source) {
    if (this.validateID(id, source)) {
      // 数値として処理
      return { id: Number(id), type: 'number' };
    } else {
      // 文字列として処理
      return { id: String(id), type: 'string' };
    }
  }
}

// 使用例
const validator = new IDValidator();

// 安全な ID の処理
console.log(validator.processID(123456, 'users')); // { id: 123456, type: 'number' }

// 安全でない ID の処理
const largeID = '9007199254740993'; // MAX_SAFE_INTEGER + 2
console.log(validator.processID(largeID, 'products')); // { id: "9007199254740993", type: 'string' }

このプログラムでは、外部ソースから取得した ID 値が安全な整数の範囲内にあるかをチェックし、安全でない場合は文字列として処理するユーティリティクラスの例を示しています。これにより、大きな ID 値を扱う際の精度の問題を回避することができます。