Chrome headlessのprint-to-pdfでヘッダーが消えない原因と回避策

HTMLで作った見積書や資料を、Chromeのヘッドレス(画面を出さずに動かすChrome)でPDFにしている方は多いと思います。ところが、ヘッダーを消すつもりのフラグを付けているのに、全ページの上と下に日時やファイルパスが入ってしまうことがあります。客先に出す書類にパソコンの中のフォルダ名が載るので、そのままでは送れません。
この記事の結論
- 弊社の Chrome 151 では、
--print-to-pdf-no-headerを付けても、全ページに日時とファイルパスが入りました。 - いまの Chromium のソースで、ヘッドレスの印刷のヘッダーとフッターを止めるスイッチは
--no-pdf-header-footerだけです。--print-to-pdf-no-headerという名前は定義されていません。 - フラグを
--no-pdf-header-footerに替えるか、CDP のPage.printToPDFにdisplayHeaderFooter: falseを渡せば消えます。 - 直ったかどうかは、PDFから文字を取り出して日時と
file:///を探せば1コマンドで分かります。
実際に起きたこと
弊社では、HTMLの書類をPDFにするコマンドを社内の手順書の何か所かに書いて使っていました。次のコマンドです。
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless --disable-gpu \
--print-to-pdf="out.pdf" --print-to-pdf-no-header --virtual-time-budget=3000 "file://..."
2026-08-19 にこのコマンドで作ったPDFを開くと、全ページにヘッダーとフッターが入っていました。入っていたのは次のものです。
| 場所 | 入っていたもの |
|---|---|
| ヘッダーの左 | PDFを作った日時(例:2026/08/19 10:39) |
| ヘッダーの中央 | HTMLの <title> の文字 |
| フッターの左 | file:///Users/XXXX/... で始まるローカルのファイルパス |
| フッターの右 | ページ番号(例:4/13) |
いちばん困るのはフッターのパスです。パソコンのユーザー名やフォルダ名がそのまま客に見えてしまいます。客先に出す書類としては使えない状態でした。
--headless=old(古いヘッドレスを指定するフラグ)を付けて作り直しても、ヘッダーとフッターは消えませんでした。ただし、この試した結果から言えることには限りがあります。理由は「原因」の節で書きます。
同じコマンドが手順書に残っていたので、過去に作った提出物にも入っているかもしれない、という心配も出ました。
原因
入っていたのは Chrome の印刷用ヘッダーとフッター
Chrome には、印刷のときにページの上と下へ情報を入れる仕組みがあります。CDP(Chrome DevTools Protocol。外のプログラムから Chrome を操作するための仕組み)の定義を見ると、Page.printToPDF のヘッダー用テンプレートには、次の値を差し込めると書かれています。フッターも同じ形式です。
date:印刷した日時title:ページのタイトルurl:ページの場所pageNumberとtotalPages:今のページと全体のページ数
弊社のPDFに入っていた日時、タイトル、file:/// のパス、ページ番号は、この並びとそのまま重なります。印刷用のヘッダーとフッターが止められずに出ていた、ということです。
–print-to-pdf-no-header は Chrome が見ていない名前
ヘッドレスのコマンドを扱う Chromium のソース(GitHub の chromium/chromium の main ブランチ)を読みました。スイッチ(起動のときに渡すフラグ)の名前を決めているのは components/headless/command_handler/headless_command_switches.cc です。印刷に関わる名前は print-to-pdf などで、PDF のヘッダーとフッターに関わる定義は次のものだけです。
// Do not display header and footer in the printed PDF file.
const char kNoPDFHeaderFooter[] = "no-pdf-header-footer";
このファイルと、同じフォルダの headless_command_handler.cc、headless_command.js を開いて、print-to-pdf-no-header という文字を探しました。どのファイルにもありませんでした。
処理の本体の headless_command_handler.cc は、--no-pdf-header-footer が付いているときだけ、noHeaderFooter という設定を立てます。
if (command_line->HasSwitch(switches::kNoPDFHeaderFooter)) {
params.Set("noHeaderFooter", true);
}
この設定を受けて実際に印刷するのは headless_command.js です。ここで、ヘッダーとフッターを出すかどうかを次の一行で決めています。
const displayHeaderFooter = !params.noHeaderFooter;
noHeaderFooter が立っていなければ、displayHeaderFooter は true になります。つまり、ヘッドレスの --print-to-pdf は、スイッチがなければ自分で true を渡して印刷しています。そのため、何も指定しなければヘッダーとフッターが入ります。
--print-to-pdf-no-header は壊れているのではありません。印刷の処理がその名前を見ていないので、付けても何も変わらないのです。読んだのは今の main ブランチで、Chrome 151 の版そのもののソースではありません。それでも、弊社が Chrome 151 で試した結果とは合っています。
2026-08-22 には、過去に作った案内資料を検査しました。こちらは日時もパスも出ていませんでした。作るときに使っていたフラグが --no-pdf-header-footer だったからです。
| フラグ | Chrome 151 で試した結果 |
|---|---|
--print-to-pdf-no-header |
無視される。日時と file:/// が全ページに入る |
--no-pdf-header-footer |
効く。ヘッダーもフッターも出ない |
–headless=old で試した結果の読み方
Chrome の公式ドキュメントでは、Chrome 132.0.6793.0 から、古いヘッドレスは chrome-headless-shell という別のプログラムとしてだけ配られていると書かれています。いまの Chrome は、ヘッドレスと画面ありの動き方がひとつにまとめられています。
弊社が試したのは Chrome 151 の本体です。そのため、--headless=old を付けたときに古いヘッドレスで動いていたとは言えません。「古いヘッドレスでも消えない」ことを確かめたわけではない、と受け取ってください。
直し方
まず今のコマンドのフラグを確かめる
PDFを作っているコマンドやスクリプトの中で、どちらのフラグを使っているかを見ます。--print-to-pdf-no-header を使っているなら、--no-pdf-header-footer に替えます。
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless --disable-gpu \
--print-to-pdf="out.pdf" --no-pdf-header-footer --virtual-time-budget=3000 "file://..."
--print-to-pdf は、用紙の大きさを HTML の @page の指定に合わせて決めます。弊社で過去に作った案内資料は、1080×607.92pts の用紙になっていました。すでに出したPDFと同じ体裁で作り直したいときは、このフラグの差し替えで作り直します。
用紙と余白を固定したいなら CDP で印刷する
見積書のように A4 で揃えたい書類は、CDP の Page.printToPDF を直接呼ぶ方法に切り替えました。弊社では html2pdf.mjs というスクリプトでこれを呼び、displayHeaderFooter: false を明示しています。設定は次のとおりです。
- 用紙は A4、余白は0.4inch、背景も印刷する(
printBackground: true) Page.loadEventFired(ページの読み込みが終わった合図)を待ってから、さらに+1.5秒待つ。Webフォントや画像の描画が終わるのを待つためです- Node.js に組み込みの WebSocket を使い、
wsや Playwright などの追加のパッケージは使わない
Node.js の公式ドキュメントでは、WebSocket が --experimental-websocket フラグなしで使えるようになったのは v22.0.0 からです。スクリプトを動かす前に、node --version で版を確かめてください。
CDP の Page.printToPDF をじかに呼ぶときは、displayHeaderFooter の初期値は false です。ヘッドレスの --print-to-pdf でヘッダーが出たのは、上で見たとおり、印刷の処理が自分で true を渡していたからです。それでも false を明示しておくと、あとから読んだ人が意図を取り違えません。
流れは次のとおりです。
- 使い捨てのプロファイル(設定や履歴を入れるフォルダ)で、CDP をつなげる状態の Chrome を起動する
http://localhost:9333/jsonを開き、つなぎ先のページの WebSocket の URL を取る- その URL に WebSocket でつなぎ、最初に
Page.enableを送る Page.navigateでHTMLを開き、Page.loadEventFiredを待つ- 少し待ってから
Page.printToPDFを呼び、返ってきたデータをファイルに書く
まず Chrome を起動します。
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless \
--remote-debugging-port=9333 --user-data-dir="$(mktemp -d)" about:blank
次に、つなぎ先を取ります。Chromium のソース(content/browser/devtools/devtools_http_handler.cc)では、/json のように後ろが空のときは一覧(list)として扱います。一覧の各項目には webSocketDebuggerUrl が入り、形は ws://localhost:9333/devtools/page/XXXX です。
curl -s http://localhost:9333/json
つないだら、最初に Page.enable を送ります。CDP の定義では、これは Page ドメインの通知を有効にする命令です。送らずに進めると、読み込みの合図の Page.loadEventFired を待ったまま止まります。
下は流れを一本にした例です。弊社のスクリプトそのものではありません。使い捨てのプロファイルで about:blank だけを開いているので、一覧の最初の項目をつなぎ先にしています。Page.printToPDF の返り値は data という名前で、PDFが base64(データを文字で表す形式)で入っています。
import { writeFileSync } from 'node:fs';
import { pathToFileURL } from 'node:url';
const [input, output] = process.argv.slice(2);
const list = await (await fetch('http://localhost:9333/json')).json();
const ws = new WebSocket(list[0].webSocketDebuggerUrl);
await new Promise((r) => ws.addEventListener('open', r, { once: true }));
let id = 0;
const waiting = new Map();
let onLoad = () => {};
ws.addEventListener('message', (ev) => {
const msg = JSON.parse(ev.data);
if (msg.id && waiting.has(msg.id)) waiting.get(msg.id)(msg.result);
if (msg.method === 'Page.loadEventFired') onLoad();
});
const send = (method, params = {}) => new Promise((r) => {
waiting.set(++id, r);
ws.send(JSON.stringify({ id, method, params }));
});
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
await send('Page.enable'); // これを先に送らないと読み込みの合図が届かない
const loaded = new Promise((r) => { onLoad = r; });
await send('Page.navigate', { url: pathToFileURL(input).href });
await loaded;
await sleep(1500); // Webフォントや画像の描画を待つ
const { data } = await send('Page.printToPDF', {
displayHeaderFooter: false, // ヘッダーとフッターを出さない
printBackground: true,
paperWidth: 8.27, // A4(インチ)
paperHeight: 11.69,
marginTop: 0.4, marginBottom: 0.4, marginLeft: 0.4, marginRight: 0.4,
});
writeFileSync(output, Buffer.from(data, 'base64'));
ws.close();
弊社では、これを run-pdf.sh という小さなシェルスクリプトから呼び、入力と出力のファイル名だけを渡しています。
~/scripts/cdp-e2e/run-pdf.sh 見積書.html 見積書_20260819.pdf
止めるのは自分が起動した Chrome だけにする
後片付けで pkill -f "Google Chrome" のような広い止め方をしてはいけません。ふだん使っている Chrome や、Playwright(ブラウザを自動で操作する道具)が動かしている Chrome まで止まってしまいます。使い捨てのプロファイルで起動し、自分が掴んだプロセスだけを止めます。Mac で常駐させるプログラムの起動と止め方は、n8nをMacにインストールして常時動かす|launchdと二重起動の直し方でも扱っています。
作り直したPDFは別の名前で出す
作り直したPDFを同じ名前で上書きすると、macOS のプレビューが古い中身を表示することがありました。2026-08-19 には、作り直したPDFを開いたら旧版が出て、文字が虫食いのように見えました。実際の新しいPDFには問題がありませんでした。
それからは、PDFのファイル名に日付を入れて別名で出しています。古い版は _old/ というフォルダへ移します。
直ったかを確かめる
pdftotext(PDFから文字を取り出すコマンド)で中身を文字にして、日時の形と file:/// を探します。何も出なければ合格です。何か出たら作り直します。
pdftotext -layout out.pdf - | grep -E '20[0-9]{2}/[0-9]{2}/[0-9]{2} +[0-9]{2}:[0-9]{2}|file:///'
過去に作ったPDFをまとめて点検するときは、件数で見ると分かりやすいです。何も入っていなければ 0 が出ます。
pdftotext -layout 対象.pdf - | grep -cE 'file:///|[0-9]{4}/[0-9]{2}/[0-9]{2}[, ]+[0-9]{1,2}:'
どちらの式も、日時を「2026/08/19 10:39」の並びで探します。これは、弊社の環境のPDFに入っていた日時の形に合わせたものです。ほかの環境では、日時が別の形で入るかもしれません。その場合は、まずヘッダーが入ったPDFを pdftotext で文字にして、日時がどんな形で出ているかを見てから、式を合わせてください。file:/// の検査は、日時の形に関係なく使えます。
弊社では、送る前の検品として Python でも同じことを確かめています。先頭の行の F には、調べたいPDFのファイル名を入れます。
F = 'out.pdf' # 調べたいPDFのファイル名
import subprocess,re
o=subprocess.run(['pdftotext','-layout',F,'-'],capture_output=True,text=True).stdout
print('ヘッダー:', bool(re.search(r'20\d\d/\d\d/\d\d\s+\d\d:\d\d',o)), '/ フッター:', 'file:///' in o)
文字が正しく取り出せても、画面での見え方(文字の形)は別の問題です。大事な提出物は、PDFを実際に開いてページを目で見ます。
過去の提出物を点検するときは、「同じコマンドで作ったはずだ」と決めつけないでください。弊社でも、入っているかもしれないと思った資料を検査したら、9ページすべてで日時もパスも0件でした。どちらのフラグで作ったかと、実物の中身の両方を確かめます。
それでも直らないとき
Chrome が終わらない
ヘッドレスの Chrome が、PDFを作ったあともプロセスとして残ることがあります。ただ、PDFはその前に書き出されています。時間切れで止まったように見えたら、まず出力先のファイルを見てください。
CDP のスクリプトが読み込みを待ったまま進まない
Page.navigate より前に Page.enable を送っているかを見ます。送っていなければ、Page.loadEventFired の合図を受け取れません。
用紙の大きさが前と違う
CDP で A4 に固定すると、@page で大きさを決めていた資料は見た目が変わります。前と同じ体裁で差し替えたいときは、--no-pdf-header-footer に差し替えたコマンドで作り直します。
フラグを替えたのにまだ出る
コマンドの中に --print-to-pdf-no-header が残っていないか、スペルが --no-pdf-header-footer と一字一句同じかを見ます。印刷の処理が見ているのはこの名前だけなので、一字でも違えば効きません。同じ名前で上書きして、プレビューが古い中身を出している場合もあります。日付入りの別名で出し直してください。
まとめ
- Chrome 151 では
--print-to-pdf-no-headerを付けても、全ページに日時、タイトル、ファイルパス、ページ番号が入りました。 - いまの Chromium のソースで、ヘッドレスの印刷のヘッダーとフッターを止めるスイッチは
--no-pdf-header-footerだけです。付けなければ、印刷の処理はdisplayHeaderFooterを true にします。 - A4 などに固定したい書類は、CDP の
Page.printToPDFにdisplayHeaderFooter: falseを渡して作ります。つないだら最初にPage.enableを送ります。 - 止めるのは自分が起動した Chrome だけにし、作り直したPDFは日付入りの別名で出します。
- 送る前に pdftotext で日時と
file:///を探し、最後は目でも見ます。
参考にした公式ドキュメント






