Console.table()
非標準
この機能は標準ではなく、標準化の予定もありません。公開されているウェブサイトには使用しないでください。ユーザーによっては使用できないことがあります。実装ごとに大きな差があることもあり、将来は振る舞いが変わるかもしれません。
表形式のデータを、表で表示します。
この関数は必須の引数 data
があり、これは配列またはオブジェクトでなければなりません。また、省略可能な引数 columns
もあります。
data
を表として出力します。配列の各要素 (data
がオブジェクトである場合は、列挙可能なプロパティ) が、表の行になります。
表の 1 番目の列に、(添字)
というラベルがつきます。data
が配列である場合、この値は配列の添字になります。data
がオブジェクトである場合、この値はプロパティ名になります。(Firefox では) console.table
は表示する行が 1000 行 (最初の行は見出し) に制限されていますので注意してください。
注:
この機能は Web Worker 内で利用可能です。プリミティブ型の集合
引数 data
に、配列またはオブジェクトを渡すことができます。
// 文字列の配列
console.table(["apples", "oranges", "bananas"]);
// 値が文字列のプロパティを持つオブジェクト
function Person(firstName, lastName) {
this.firstName = firstName;
this.lastName = lastName;
}
var me = new Person("John", "Smith");
console.table(me);
複合的な型の集合
配列の要素やオブジェクトのプロパティ自体が配列やオブジェクトである場合、それらの要素やプロパティを 1 列ずつ置く形で、各行に列挙します:
// 配列の配列
var people = [["John", "Smith"], ["Jane", "Doe"], ["Emily", "Jones"]]
console.table(people);
// オブジェクトの配列
function Person(firstName, lastName) {
this.firstName = firstName;
this.lastName = lastName;
}
var john = new Person("John", "Smith");
var jane = new Person("Jane", "Doe");
var emily = new Person("Emily", "Jones");
console.table([john, jane, emily]);
配列がオブジェクトを含む場合、表の列名はプロパティ名になります。
// 値がオブジェクトのプロパティを持つオブジェクト
var family = {};
family.mother = new Person("Jane", "Smith");
family.father = new Person("John", "Smith");
family.daughter = new Person("Emily", "Smith");
console.table(family);
表示する列を制限する
デフォルトでは、console.table()
はすべての要素を各行に出力します。省略可能な引数 columns
を使用して、表示する列のサブセットを選択できます:
// オブジェクトの配列、ただし firstName のみ表示
function Person(firstName, lastName) {
this.firstName = firstName;
this.lastName = lastName;
}
var john = new Person("John", "Smith");
var jane = new Person("Jane", "Doe");
var emily = new Person("Emily", "Jones");
console.table([john, jane, emily], ["firstName"]);
列で並べ替える
列の見出しをクリックすると、その列の値で表を並べ替えることができます。
構文
console.table(data [, columns]);
引数
data
- 表示するデータ。配列またはオブジェクトでなければなりません。
columns
- 出力する列名を持つ配列。
仕様
仕様書 | 策定状況 | コメント |
---|---|---|
Console API console.table() の定義 |
現行の標準 | 最初期の定義 |
ブラウザ実装状況
BCD tables only load in the browser