Module: CopyTunerClient::Copyray::Rewriter

Defined in:
lib/copy_tuner_client/copyray/rewriter.rb

Overview

完成 HTML を走査し、マーカートークンを含むテキストノードの親要素・属性値を持つ要素にdata-copyray-key 属性を付与し、トークンを完全に除去する。CopyrayMiddleware の HTML 後処理（CSS/JS 挿入）の前段で呼ばれる。

Constant Summary collapse

DATA_ATTR = 
'data-copyray-key'.freeze
MAX_REWRITE_BYTESIZE =

NOTE: マーカーを含む巨大 HTML を Nokogiri で parse/traverse/再シリアライズするとサイズに比例して重くなる（実測 ~1MB で 167ms, ~3MB で 514ms）。development 限定機能でレスポンスを大きく悪化させないため、この閾値超では Nokogiri を通さず可視トークン除去のみ行う。失うのは data-copyray-key（オーバーレイ編集導線）だけで、フォールバックの gsub は巨大ページでも数ms。

1_000_000

Class Method Summary collapse

Class Method Details

.rewrite(html) ⇒ Object

NOTE: 戻り値は [html, skipped]。skipped は data-copyray-key を付与できなかったことを表す（巨大DOMでのスキップ・Nokogiri 例外の双方で true）。ミドルウェアがこれを JS に伝え、オーバーレイ非対応である旨をツールバーで案内する。



22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
 
# File 'lib/copy_tuner_client/copyray/rewriter.rb', line 22

def rewrite(html)
  # NOTE: ボディが ASCII-8BIT に転落していると UTF-8 の Marker::PREFIX との include? 比較が
  # Encoding::CompatibilityError を投げる（ミドルウェアのボディ連結で非ASCIIバイトを含む
  # ASCII-8BIT チャンクが混じると発生）。実バイト列は本来 UTF-8 なので判定用に UTF-8 とみなす。
  # String.new でエンコーディングだけ付け替える（元オブジェクトを破壊せずバッファもコピーしない）。
  scannable = html.encoding == Encoding::UTF_8 ? html : String.new(html, encoding: Encoding::UTF_8)

  # NOTE: マーカーが無ければ Copyray 無効時・マーカーの無い通常ページなので一切変形しない（高速パス）。
  # これによりマーカー非注入の HTML は完全に無傷で、Nokogiri の正規化も通らない。
  # （そもそも CopyrayMiddleware は development 限定で本番のスタックには登録されず、本番では呼ばれない。）
  # 判定は正規表現より安い部分文字列検索で行う（プレフィックスがあれば必ずマーカー候補）。
  return [html, false] unless scannable.include?(Marker::PREFIX)

  # NOTE: 閾値超は Nokogiri を通さず可視トークン除去のみ。skipped=true で編集導線を諦めた旨を伝える。
  return [strip_markers(scannable), true] if scannable.bytesize > MAX_REWRITE_BYTESIZE

  [rewrite_with_nokogiri(scannable), false]
rescue StandardError => e
  # NOTE: Copyray は開発支援機能なので、壊れた HTML 等で Nokogiri 処理が落ちても
  # ページを 500 にしない。data-copyray-key 付与（編集導線）は諦め、最低限可視トークンだけ除去する。
  warn_rewrite_failure(e)
  [strip_markers(scannable), true]
end