ndjson は複数の JSON データが改行区切りで集まった文字列情報です。例えば、次です。
{"datetime":"2021-10-06T11:04:19.461065+09:00","message":"課金処理","level_name":"INFO"} {"datetime":"2021-10-06T11:04:19.467941+09:00","message":"file_get_contents(): Read of 8192 bytes failed with errno=21 Is a directory...","level_name":"ERROR"}
ndjson
例にあるようにログを構造的に記録していく時に便利です。もし普通の JSON 形式ですとログファイル全体を読み直すか、ファイルの末尾を毎回 JSON として成立する様に書き込まなければなくなり、不穏な挙動を示します(一貫性等考えなくていい単純な行追記の方が楽という懐事情も)。
毎回毎回 jq を使ってコマンドラインでログの内容を確認するのも手ですが、ブラウザ上から簡易に確認したい時もあります。そういった時は次の様なコードが役に立ちます。
stedolan/jq: Command-line JSON processor
<label for="">プロパティ<input type="text" id="key" ></label> <label for="">フィルタ<input type="text" id="query" ></label> <pre id="display"></pre>
/** axios や埋め込みなどでどこからか取得した ndJSON 形式のデータ */ const ndJsonContent = `{"datetime":"2021-10-06T11:04:19.461065+09:00","message":"課金処理","level_name":"INFO"} {"datetime":"2021-10-06T11:04:19.467941+09:00","message":"file_get_contents(): Read of 8192 bytes failed with errno=21 Is a directory...","level_name":"ERROR"}` .split("\n") // 行単位で分割 .filter(l=>l) // 空行を除去 .map(line => JSON.parse(line)); // 各行を JSON として解釈 /** 結果を表示する要素 */ const dEl = document.getElementById('display'); /** filterを欠けるプロパティを value に持つ input 要素 */ const kEl = document.getElementById('key'); /** filterに使う文字列を value に持つ input 要素 */ const qEl = document.getElementById('query'); // 初期化 dEl.innerText = JSON.stringify(ndJsonContent, null, 2); /** kEl, qEl の value を見て、表示を適切に変更する関数 */ const updater = () => { dEl.innerText = JSON.stringify( // ndJSON のうち、kEl で指定されたプロパティを qEl で絞り込む // ここでは単に一列目のプロパティアクセスですが、dot-prop 等を使って1文字列でネストさせることもできます // @see https://www.npmjs.com/package/dot-prop // filter のみを使っていますが、同様に任意のプロパティと任意の値と配列メソッド(map等)を組み合わせるとより多様なことができます。 ndJsonContent.filter(item=>item[kEl.value].includes(qEl.value)), null, 2 ); } // ↑の表示更新関数を Event として登録 qEl.addEventListener('input',updater) kEl.addEventListener('input',updater)
実際に動かしたデモが次です
こんな感じにすると次の様に jq 的なクエリが作れます。例は単に一つの filter ですが、map を使う、範囲指定をする、クエリ数や種類を可変にするなど色々拡張できます。