Cybozu Frontend Monthly #72

タイトル画像

イベント概要

サイボウズフロントエンドマンスリーは、サイボウズ社内で行っているフロントエンド情報共有会「フロントエンドウィークリー」の公開版です。

その月に気になったフロントエンドの情報を、サイボウズのフロントエンドエンジニアのメンバーが共有していきます。

このイベントのハッシュタグは #サイボウズフロントエンドマンスリー です。

※フロントエンドウィークリーとは

毎週火曜の 17:00 〜 18:00 で社内向けに行っているフロントエンドの気になる記事を紹介する会です。
2016年3月15日から行われています。

ZennのPublicationにてウィークリーのまとめを投稿していますので、ぜひこちらもご覧ください。https://zenn.dev/p/cybozu_frontend

開催日

2026年10月27日

イベントページ

https://cybozu.connpass.com/event/409212/

メンバー


コンテンツ

👀 Notable Articles

cccc

コードの認知の複雑度や循環的な複雑度を高速に測定する CLI ツールです。非常に多くの言語に対応しており、フロントエンド視点では TypeScript/JavaScript にも対応しています。

従来から人間がコードを書く際にも複雑度を下げて可読性を保つことは推奨されていましたが、AI にコードを書かせる際にも、適当に投げると非常に煩雑なコードになりえます。

レビューでの把握は困難ですし、AI での継続的なメンテナンス時にも影響範囲が広がったりとデメリットが大きいです。対策としてプロンプトに「シンプルにする」「分岐を深くしない」といった指示を含めてある程度コントロールできますが、モデルの性能に大きく依存します。

cccc ではコードの複雑度を数値化できるため、決定論的に是非を判定することができます。

例として、次のお題での CSV パーサを AI に書かせてみます。

# プロンプト

簡易 CSV パーサを単一のjsファイルに書いてください。
ダブルクォート内のカンマ、"" によるエスケープ、改行、空フィールドを1文字ずつ処理します。

Sonnet 5.5 に書かせたコードが以下です。

コードを開く
/**
 * 簡易 CSV パーサ。
 * 1文字ずつ処理し、以下に対応する。
 *  - ダブルクォート内のカンマ
 *  - "" によるダブルクォートのエスケープ
 *  - クォート内の改行
 *  - 空フィールド
 *  - 改行コード (\n, \r\n, \r)
 *
 * @param {string} text
 * @param {string} [delimiter=","]
 * @returns {string[][]}
 */
function parseCsv(text, delimiter = ",") {
  const rows = [];
  let row = [];
  let field = "";
  let inQuotes = false;

  for (let i = 0; i < text.length; i++) {
    const ch = text[i];

    if (inQuotes) {
      if (ch === '"') {
        if (text[i + 1] === '"') {
          field += '"';
          i++;
        } else {
          inQuotes = false;
        }
      } else {
        field += ch;
      }
      continue;
    }

    if (ch === '"') {
      inQuotes = true;
    } else if (ch === delimiter) {
      row.push(field);
      field = "";
    } else if (ch === "\n" || ch === "\r") {
      if (ch === "\r" && text[i + 1] === "\n") i++;
      row.push(field);
      rows.push(row);
      row = [];
      field = "";
    } else {
      field += ch;
    }
  }

  // 末尾に改行がない場合の最終行を確定する
  if (field !== "" || row.length > 0) {
    row.push(field);
    rows.push(row);
  }

  return rows;
}

module.exports = { parseCsv };

if (require.main === module) {
  const sample = 'name,note,empty\n"Smith, John","He said ""hi""",\n"multi\nline",x,\r\n,,';
  console.log(JSON.stringify(parseCsv(sample), null, 2));
}

関数分割もされておらず、巨大な単一関数になってしまいました。これを、cccc で分析すると、次のような結果がでます

./csv-parser.js
  Cognitive  Cyclomatic  Function
         24          13    parseCsv [function] (L14)
  ------------------------------------------------
  file total: cognitive=25 cyclomatic=14

summary (1 files, 1 functions)
                sum   max  median   p90   p95
  cognitive      24    24      24    24    24
  cyclomatic     13    13      13    13    13

cognitive は認知の複雑度、cyclomatic は循環的な複雑度を表しています。

では、このコードの cognitive および は認知の複雑度、cyclomatic の上限を 10 になるよう Sonnet にリファクタリングさせてみましょう。

# プロンプト
cccc --table ./csv-parser.js で複雑度や循環度を測定し、
cognitive および cyclomatic は 10 を上限となるよう改善してください。

結果、書き直されたのが次のコードです

コードを開く
/**
 * 簡易 CSV パーサ。
 * 1文字ずつ処理し、以下に対応する。
 *  - ダブルクォート内のカンマ
 *  - "" によるダブルクォートのエスケープ
 *  - クォート内の改行
 *  - 空フィールド
 *  - 改行コード (\n, \r\n, \r)
 */

const QUOTE = '"';

const isNewline = (ch) => ch === "\n" || ch === "\r";

// \r\n を1つの改行として扱うために、先読みで消費すべき追加文字数を返す
const newlineExtraLength = (ch, next) => (ch === "\r" && next === "\n" ? 1 : 0);

const createState = () => ({
  rows: [],
  row: [],
  field: "",
  inQuotes: false,
});

const endField = (state) => {
  state.row.push(state.field);
  state.field = "";
};

const endRow = (state) => {
  endField(state);
  state.rows.push(state.row);
  state.row = [];
};

/**
 * クォート内の1文字を処理する。
 * @returns {number} 追加で読み飛ばす文字数
 */
const consumeQuoted = (state, ch, next) => {
  if (ch !== QUOTE) {
    state.field += ch;
    return 0;
  }
  if (next === QUOTE) {
    state.field += QUOTE;
    return 1;
  }
  state.inQuotes = false;
  return 0;
};

/**
 * クォート外の1文字を処理する。
 * @returns {number} 追加で読み飛ばす文字数
 */
const consumeUnquoted = (state, ch, next, delimiter) => {
  if (ch === QUOTE) {
    state.inQuotes = true;
  } else if (ch === delimiter) {
    endField(state);
  } else if (isNewline(ch)) {
    endRow(state);
    return newlineExtraLength(ch, next);
  } else {
    state.field += ch;
  }
  return 0;
};

const consumeChar = (state, ch, next, delimiter) =>
  state.inQuotes
    ? consumeQuoted(state, ch, next)
    : consumeUnquoted(state, ch, next, delimiter);

// 末尾に改行がない場合の最終行を確定する
const finish = (state) => {
  if (state.field !== "" || state.row.length > 0) endRow(state);
  return state.rows;
};

/**
 * @param {string} text
 * @param {string} [delimiter=","]
 * @returns {string[][]}
 */
function parseCsv(text, delimiter = ",") {
  const state = createState();
  for (let i = 0; i < text.length; i++) {
    i += consumeChar(state, text[i], text[i + 1], delimiter);
  }
  return finish(state);
}

module.exports = { parseCsv };

if (require.main === module) {
  const sample = 'name,note,empty\n"Smith, John","He said ""hi""",\n"multi\nline",x,\r\n,,';
  console.log(JSON.stringify(parseCsv(sample)));
}

適宜分割されており、個々の関数も役割に応じた小さいものになっています。

改めて cccc で複雑度や循環度を計測すると次のような結果となります。

./csv-parser.js
  Cognitive  Cyclomatic  Function
          4           4    consumeUnquoted [arrow] (L57)
          2           3    newlineExtraLength [arrow] (L16)
          2           3    consumeQuoted [arrow] (L40)
          2           3    finish [arrow] (L77)
          1           2    isNewline [arrow] (L13)
          1           2    consumeChar [arrow] (L71)
          1           2    parseCsv [function] (L87)
          0           1    createState [arrow] (L18)
          0           1    endField [arrow] (L25)
          0           1    endRow [arrow] (L30)
  ------------------------------------------------
  file total: cognitive=14 cyclomatic=23

summary (1 files, 10 functions)
                sum   max  median   p90   p95
  cognitive      13     4       1     2     4
  cyclomatic     22     4       2     3     4

個々の関数の cognitive や cyclomatic がかなり小さくなっており、複雑度や循環度が抑えられていることが数値からもわかります。

コードを書かせる際に「もっとわかりやすくしてくれよ〜〜〜」とプロンプトで試行錯誤することも多いのですが、Lint や Formatter のようにハーネスとして試してみるとよいかもしれません。

Deno is joining Cloudflare

Deno の開発チーム全員が Cloudflare に join することが発表されました。

これに伴い、Deno の運用が変わります。

Introducing tsrs: A port of TypeScript to Rust

TypeScript コンパイラの Rust 移植 tsrs が Oxc のプロジェクトに加わりました。

TypeScript 7.1 beta

TypeScript の v7.1 Beta が公開されました。その中でも TypeScript 7.1 API の提供は目玉となりそうです。

TypeScript 7.1 API の提供

TS6 系まで提供されていた TypeScript Compiler API は Go 移植された TS7.0 では利用できなくなり、外部ツールは依然として TS6 系を使い続ける必要がありました。これに対して TS7.1 では全く新しい形の外部向け API が公開されることとなりました。

新しい API の特徴としては次の 3 点が挙げられます。

用途ごとに分割されて提供されることになった API

新しい API は大きく以下の 4 つに分割され、用途に応じて使い分けられるようになっています。

変更情報だけを渡して軽量なチェックを可能にするスナップショットベースの仕組み

プロジェクトの解析を行う際、状態を「スナップショット」として保持するようになりました。そのためツール側は変更したファイルだけを渡せば新しい状態を得ることができ、TypeScript 側も毎回全情報を渡し直して作り直すオーバーヘッドを削ることができます。

独自拡張子をサポートする「Content Mappers」

.vue、.svelte、.astro、.mdx といった独自ファイル(HTML/CSS/JS などを 1 ファイルに含む形式)を扱うための公式プラグイン機構が追加されました。

Content Mappers では下記のように tsconfig に宣言することでどの拡張子をどのプラグインに処理させるかを決めることができます(@vue/content-mapperは記事中の例で、現時点では npm に公開されていません)。

{
  "compilerOptions": {
    "strict": true
  },
  "contentMappers": [
    {
      "package": "@vue/content-mapper",
      "extensions": [".vue"]
    }
  ]
}

プラグイン側は、元のファイルから TypeScript に見せるための仮想的なコードを作り、その中のコードが元のファイルのどの領域に対応するかの情報と一緒に返します。TS 側はこの対応関係を使うことで、埋め込まれた JS/TS の部分に対しても正確な位置でエラーを報告したり、エディタの機能を提供したりできます。

なお、content mapper は任意のコードを実行することになるため、tscで使うには--runExternalCodeフラグの指定が必要です。VS Code ではワークスペースの信頼と content mapper の実行許可が必要で、js/ts.contentMappers.enabledの設定で無効にもできます。

🗓 Monthly Articles

📖 Framework, Library

⚡️ Services

🖥 Browsers

💬 Languages

🤖 Runtimes

📝 Specifications

🦆 Others