JavaScript at()メソッド
例
整数値を受け取り、そのインデックスに対応する要素を返します:
const array1 = [5, 12, 8, 130, 44];
let index1 = 2;
strt1= `インデックスは ${index1}の値は ${array1.at(index1)}`;
document.getElementById("demo1").innerHTML = strt1;
let index2 = -2;
strt2= `インデックスは ${index2}の値は ${array1.at(index2)}`;
document.getElementById("demo2").innerHTML = strt2;
試してみる »
定義と用法
at() メソッドは整数値を受け取り、そのインデックスに対応する要素を返します。正の数と負の数を許可します。負の整数は配列の最後の要素から逆に数えます。
指定されたインデックスに一致する配列内の要素。指定されたインデックスが見つからない場合は undefined を返します。
非負の数を渡す場合、at() メソッドは括弧記法と同等です。例えば、array
通常の方法は、length にアクセスし、それから末尾からの相対インデックスを引くことです。例えば、array[array.length - 1] です。at() メソッドは相対インデックスを許可するため、上記の例は array.at(-1) に簡略化できます。より正式には、index < 0 の場合、このメソッドはインデックス index + array.length にアクセスします。
at() メソッドは汎用的です。this に length プロパティと整数をキーとするプロパティがあることのみを期待します。
ブラウザ対応
表内の数字は、そのメソッドをサポートする最初のブラウザバージョン番号を示しています。
| メソッド | |||||
|---|---|---|---|---|---|
| at() | 45.0 | 12.0 | 32.0 | 9 | 25.0 |
構文
at(index)
引数
| 引数 | 説明 |
| index | 返す配列要素のインデックス(位置)。負数を渡すと、配列の末尾からの相対インデックスがサポートされます。つまり、負数を使用すると、返される要素は配列の末尾から逆に数えた位置になります。 |
技術詳細
| 戻り値: | 要素。 |
| JavaScript バージョン: | ECMAScript 6 |
その他の例
配列の最後の値を返す:以下の例は、指定された配列内で見つかった最後の要素を返す関数を示しています。
例
// 配列と配列要素
const cart = ['apple', 'banana', 'pear'];
// 指定された配列の最後の要素を返す関数
function returnLast(arr) {
return arr.at(-1);
}
// 'cart' 配列の最後の要素を取得
const item1 = returnLast(cart);
console.log(item1); // 出力:'pear'
// 'cart' 配列に要素を追加
cart.push('orange');
const item2 = returnLast(cart);
console.log(item2); // 出力:'orange'
const cart = ['apple', 'banana', 'pear'];
// 指定された配列の最後の要素を返す関数
function returnLast(arr) {
return arr.at(-1);
}
// 'cart' 配列の最後の要素を取得
const item1 = returnLast(cart);
console.log(item1); // 出力:'pear'
// 'cart' 配列に要素を追加
cart.push('orange');
const item2 = returnLast(cart);
console.log(item2); // 出力:'orange'
さまざまな配列メソッドを比較する:次の例では、配列内の末尾から2番目の要素を選択するさまざまな方法を比較しています。以下に示すすべての方法が有効ですが、この例は at() メソッドの簡潔さと読みやすさを強調しています。
例
// 配列と配列要素
const colors = ['red', 'green', 'blue'];
// length プロパティを使用
const lengthWay = colors[colors.length-2];
console.log(lengthWay); // 出力:'green'
// slice() メソッドを使用。配列が返されることに注意
const sliceWay = colors.slice(-2, -1);
console.log(sliceWay[0]); // 出力:'green'
// at() メソッドを使用
const atWay = colors.at(-2);
console.log(atWay); // 出力:'green'
const colors = ['red', 'green', 'blue'];
// length プロパティを使用
const lengthWay = colors[colors.length-2];
console.log(lengthWay); // 出力:'green'
// slice() メソッドを使用。配列が返されることに注意
const sliceWay = colors.slice(-2, -1);
console.log(sliceWay[0]); // 出力:'green'
// at() メソッドを使用
const atWay = colors.at(-2);
console.log(atWay); // 出力:'green'
配列以外のオブジェクトで at() を呼び出す:at() メソッドは this の length プロパティを読み取り、アクセスするインデックスを計算します。
例
const arrayLike = {
length: 2,
0: "a",
1: "b",
};
console.log(Array.prototype.at.call(arrayLike, -1)); // "b"
length: 2,
0: "a",
1: "b",
};
console.log(Array.prototype.at.call(arrayLike, -1)); // "b"
その他の拡張
JavaScript Array オブジェクト