Chrome DevToolsのコンソールで$0とcopy()を使う方法

​​Chrome DevTools​JavaScript

Chrome DevTools の Elements パネルで選んだ要素は、Console で $0 と打つだけで JavaScript で扱えます。copy() を使うと、その要素の HTML や、ページから集めたデータを、クリップボードに直接コピーできます。HTML 要素の data-* 属性や、実際に効いている CSS の値をその場で確かめたいときや、ページの一覧を JSON にして持ち出したいときに使える方法です。

補足

検証環境は Ubuntu 24.04、Chrome for Testing 153.0.8010.12(Playwright に入っているもの)です。仮想ディスプレイの上でウィンドウ付きの Chrome を起動し、ウィンドウの右側に開いた DevTools に、マウスとキーボードの操作を送って動かしました。DevTools の画面は英語の表示だったので、ボタンやメニューは英語の表記で書いています。クリップボードの中身は、Linux のコマンド(xclip)で読み出して確かめました。$3 と $4、JavaScript のヒープのオブジェクトを $0 で参照する使い方、jQuery のように $ を定義するライブラリを読み込んだページ、macOS と Windows の Chrome は試していません。

ここで使っている関数は、公式ドキュメントで Console Utilities API としてまとめられているものです。

検証に使ったページ

商品が3つ並んだ一覧と、ボタン、貼り付けを確かめるためのメモ欄があるだけのページです。商品の li には、data-sku と data-price の属性を付けました。2つ目の商品だけ sale クラスで文字をピンク(#d85878)にしています。

html
<p id="banner">きょうのおすすめ</p>
<ul id="items">
  <li class="item" data-sku="A-101" data-price="1200">猫の手クッション</li>
  <li class="item sale" data-sku="A-102" data-price="800">肉球マウスパッド</li>
  <li class="item" data-sku="A-103" data-price="1500">しっぽのブックマーク</li>
</ul>
<button id="buy">カートに入れる</button>
<p><label>メモ(貼り付け用)<br><textarea id="memo" rows="18" cols="58"></textarea></label></p>

Elements で選んだ要素は

Elements で選んだ要素は $0 で参照できる

で参照できる

ページの「肉球マウスパッド」を右クリックして Inspect を選ぶと、Elements パネルでその li が選ばれます。選ばれた行の右端には == $0 と表示されました。この要素は、Console では $0 という名前で参照できる、という意味です。

Elements パネルで li class="item sale" data-sku="A-102" data-price="800" の行が選ばれ、行の右端に == $0 と出ている
Inspect で選んだ li の行に == $0 が付いている

この状態で Console パネルに切り替え、次の式を順に打ちました。

text
> $0
< <li class="item sale" data-sku="A-102" data-price="800">…</li>
> $0.dataset.price
< '800'
> $0.dataset
< DOMStringMap {sku: 'A-102', price: '800'}
> getComputedStyle($0).color
< 'rgb(216, 88, 120)'
> $0.getBoundingClientRect().height
< 32

$0 はふつうの DOM の要素なので、dataset や getComputedStyle() など、ページの JavaScript で使うのと同じプロパティやメソッドがそのまま使えます。CSS で #d85878 と書いた色は、getComputedStyle() では rgb(216, 88, 120) という形で返りました。要素の高さは 32px でした。

Console パネルに $0、$0.dataset.price、$0.dataset、getComputedStyle($0).color、$0.getBoundingClientRect().height の5つの式と、その結果が並んでいる
$0 を使った5つの式の結果

前に選んだ要素は h2、

で参照できる

続けて、ページの「猫の手クッション」を右クリックして Inspect を選び直しました。そのあと Console で打つと、次のように返りました。

text
> $0.textContent
< '猫の手クッション'
> $1.textContent
< '肉球マウスパッド'
> $2
< <body>…</body>

$0 は最後に選んだ要素で、$1 はその1つ前に選んだ要素です。公式ドキュメントの $0 – $4 の説明によると、$0 から $4 までで、Elements パネルで選んだ要素を新しい順に5つまでさかのぼれます。

検証で DevTools を開いた直後、Elements パネルで選ばれていたのは <body> でした。そのため $2 は <body> になりました。2つの要素を見比べたいときは、片方を選んでからもう片方を選べば、$0 と $1 で両方を参照できます。

$()、$$()、$x() でページから要素を探す

Elements パネルで選ばなくても、セレクタで要素を探す関数があります。

関数 返すもの
$(selector) CSS セレクタに合う最初の要素
$$(selector) CSS セレクタに合う要素すべての配列
$x(path) XPath に合う要素すべての配列

公式ドキュメントでは、$() は document.querySelector() の、$$() は Array.from(document.querySelectorAll()) の代わりだと説明されています($() の説明、$$() の説明)。検証のページで試した結果は次のとおりです。エラーの行は、前後に付く発生位置の表示(VM237:1 など)を省いています。

text
> $('.item')
< <li class="item" data-sku="A-101" data-price="1200">…</li>
> $$('.item')
< (3) [li.item, li.item.sale, li.item]
> $$('.item').map(li => li.dataset.sku)
< (3) ['A-101', 'A-102', 'A-103']
> document.querySelectorAll('.item').map(li => li.dataset.sku)
< Uncaught TypeError: document.querySelectorAll(...).map is not a function
> Array.isArray($$('.item'))
< true
> $x('//li[@data-price > 1000]')
< (2) [li.item, li.item]
> $$('li', $('#items')).length
< 3

$$() が便利なのは、戻り値が本物の配列であることです。Array.isArray() は true を返し、map() をそのままつなげて、3つの商品の data-sku を取り出せました。同じことを document.querySelectorAll() でやろうとすると、戻り値が配列ではないため、map is not a function のエラーになりました。

$x() は XPath で探します。//li[@data-price > 1000] は「data-price が 1000 より大きい li」という意味で、data-price が 1200 と 1500 の2つが返りました。XPath なら、このように属性の値の大小でも絞り込めます。

3つとも、2つ目の引数に要素を渡すと、その要素の中だけを探します。$$('li', $('#items')) は #items の中の li を探し、3つ見つかりました。

Console パネルに $('.item')、$$('.item')、map で data-sku を取り出した結果、querySelectorAll に map をつなげたときの赤い TypeError、Array.isArray の true、$x の結果、$$('li', $('#items')).length の 3 が並んでいる
$()、$$()、$x() の結果。querySelectorAll() に map() をつなげた行だけエラーになる

copy() でクリップボードにコピーする

copy() に渡した値は、文字列にしてクリップボードに入ります。Console の結果は3回とも undefined でしたが、クリップボードの中身は次のように変わりました。

最初に、「肉球マウスパッド」を選び直して copy($0) を打ちました。クリップボードには、要素の HTML がそのまま入りました。

text
> copy($0)
< undefined
html
<li class="item sale" data-sku="A-102" data-price="800">肉球マウスパッド</li>

中の文字だけがほしいときは、copy($0.textContent) と打ちます。このときクリップボードに入ったのは「肉球マウスパッド」の文字だけでした。

配列を渡すと、JSON の形になります。$$() と組み合わせて、ページの一覧をまとめてコピーしてみました。

text
> copy($$('.item').map(li => ({ sku: li.dataset.sku, price: Number(li.dataset.price), name: li.textContent })))
< undefined

クリップボードには、次の文字が入りました。

json
[
    {
        "sku": "A-101",
        "price": 1200,
        "name": "猫の手クッション"
    },
    {
        "sku": "A-102",
        "price": 800,
        "name": "肉球マウスパッド"
    },
    {
        "sku": "A-103",
        "price": 1500,
        "name": "しっぽのブックマーク"
    }
]

字下げは4つの空白で、JSON.parse() で読み直すと、3件の配列に戻りました。ページのメモ欄をクリックして Ctrl+V を押すと、同じ文字がそのまま貼り付きました。ページに表示されている一覧を、テストのデータや、ほかのツールに渡す JSON にしたいときに、そのまま使えます。

ページのメモ欄に、sku、price、name を持つ3件の JSON が字下げ付きで貼り付けられている
copy() でコピーした JSON を、ページのメモ欄に貼り付けたところ

inspect() で Console から Elements パネルに戻る

逆に、Console で見つけた要素を Elements パネルで見たいときは、inspect() を使います。Console で inspect($('#buy')) を打つと、DevTools は Elements パネルに切り替わり、<button id="buy">カートに入れる</button> の行が選ばれました。Console に戻って $0 を打つと、このボタンが返りました。

text
> inspect($('#buy'))
< <button id="buy">カートに入れる</button>
> $0
< <button id="buy">カートに入れる</button>

$$() や $x() で見つけた要素がページのどこにあるのかを、DOM ツリーの中で確かめたいときに便利です。

ページの JavaScript からは使えない

ここまでの $0 や copy() は、Console で打ったときだけ使える関数です。公式ドキュメントにも、DevTools の Console から呼んだときだけ動き、ページのスクリプトからは動かないと書かれています。

検証のページでは、読み込み時に app.js で次のように記録しておきました。

js
window.pageCheck = {
  dollar0: typeof $0,
  copy: typeof copy,
  dollarDollar: typeof $$,
};

Console で typeof $0 を打つと 'object'、typeof copy は 'function' でした。一方、pageCheck の中身は {dollar0: 'undefined', copy: 'undefined', dollarDollar: 'undefined'} で、ページの JavaScript からは3つとも見えていませんでした。Console で試した式をページのコードに移すときは、$$() を Array.from(document.querySelectorAll()) に、$() を document.querySelector() に書き換える必要があります。

公式ドキュメントの $() の説明には、jQuery のように $ を使うライブラリを読み込んだページでは、Console の $ もそのライブラリのものに置き換わる、という注意もあります。

​Posted by 86