Phantis サポートページ

Phantis には、定型処理を自動化するスクリプト実行機能があります。
スクリプト言語は JavaScript (Jint) で、操作API は phantis オブジェクトとして提供されます。

type ScriptLine = {
  lineNumber: number; // 1-indexed
  offset: number;     // byte offset
  text: string;
};

type ScriptGrepMatch = {
  file: string;
  line: number;       // 1-indexed
  offset: number;     // byte offset
  text: string;
};

type ScriptBookmark = {
  lineNumber: number; // 1-indexed
  preview: string;
  comment: string;
};

type ScriptSearchOptions = {
  regex: boolean;
  caseSensitive: boolean;
  fromLine: number;   // 現状の getSearchOptions() は 1
};

type SearchOptions = {
  regex?: boolean;
  caseSensitive?: boolean;
  limit?: number;     // 0 or omitted = unlimited
  skip?: number;      // default: 0
};

type MultiFileGrepOptions = {
  regex?: boolean;
  caseSensitive?: boolean;
  filter?: string;    // "*.log;*.txt" / "*.log,*.txt"
  subdirs?: boolean;  // default: true
  limit?: number;     // 0 or omitted = unlimited
  skip?: number;      // default: 0
};

type ExecOptions = {
  timeout?: number;   // seconds, default: 30
  workdir?: string;
};

type AggregateOptions = {
  regex?: boolean;
  caseSensitive?: boolean;
  group?: number;     // 0 = match whole text, 1+ = capture group number
  limit?: number;     // 0 or omitted = unlimited
};

type AggregateResult = {
  value: string;
  count: number;
};

type ProcessMetrics = {
  cpuPercent: number;
  workingSetMB: number;
  privateMB: number;
  heapMB: number;
  readBytesPerSec: number;
  writeBytesPerSec: number;
  threads: number;
  handles: number;
};

type SelectionOffsets = { start: number; end: number }; // 選択なし: -1 / -1
type VisibleLineRange = { firstLine: number; lastLine: number };
type FindHit = { line: number; offset: number; text: string } | null;

各APIは メソッド名 / 戻り値 / 説明 の順に記載しています。 行番号は原則として 1始まり、offset はファイル先頭からの バイトオフセット です。 ファイル未オープン時は、空文字列、0、空配列、null など安全な既定値を返すAPIと、パス不正などで例外になるAPIがあります。

巨大ファイルでは、filter() / grep() / countMatches() などの全体走査APIは時間がかかります。 大量ヒットが想定される場合は limit / skip を使ってページングしてください。

同梱サンプルは scripts フォルダにあります。
入門から上級まで段階的に API を試せます。

1) 現在ファイルを抽出してフィルタパネルに表示

const hits = phantis.filter("ERROR|WARN", { regex: true, caseSensitive: false });
phantis.showInFilterPanel(hits);
phantis.setStatusMessage(`hit: ${hits.length}`);

2) 複数ファイル Grep（サブフォルダ含む）

const matches = phantis.grep("C:\\logs", "timeout", {
  regex: false,
  caseSensitive: false,
  filter: "*.log;*.txt",
  subdirs: true
});
phantis.message(`match: ${matches.length}`);

3) HEX検索してジャンプ

const pos = phantis.findBytes("FF D8 FF");
if (pos >= 0) {
  phantis.scrollToOffset(pos);
  phantis.setStatusMessage(`Found at 0x${pos.toString(16).toUpperCase()}`);
}

4) 大量ヒットのページング処理（limit / skip）

var PAGE = 5000;
var totalHits = phantis.countLinesWith("ERROR", { regex: false, caseSensitive: false });
var totalPages = Math.max(1, Math.ceil(totalHits / PAGE));

for (var page = 0; ; page++) {
  var batch = phantis.filter("ERROR", {
    regex: false,
    caseSensitive: false,
    skip: page * PAGE,
    limit: PAGE
  });
  if (batch.length === 0) break;

  // batch を処理（Jintヒープに載る件数を PAGE で制御）
  phantis.setProgress(page + 1, totalPages);
}
phantis.setStatusMessage("ページング処理が完了しました。");

作者が実際に参考にしている書籍や、開発環境を快適にするおすすめアイテムをご紹介します。
※ 以下のリンクはAmazonアソシエイトのリンクです。購入いただくと作者の収益になります。

📚 C# プログラミング書籍

• 独習C# 第5版（山田祥寛）― 入門の定番。辞書代わりにもなる一冊
• 〔速攻入門〕C#プログラミング ― 現場ですぐ使える実践的な知識が身につく
• Effective C# 6.0/7.0（Bill Wagner）― C# らしい書き方が身につく中上級者向けの名著
• C# 14 and .NET 10（Mark J. Price）― 最新 .NET 10 対応の英語リファレンス（上級者向け）

💻 PC パーツ

• SSD 1TB ― ストレージ増設・換装に
• DDR5 メモリ ― 大きなファイルを快適に扱うにはメモリ増設が効果的！