Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】Word.LineFormat lost 8 documented properties in Office.js 16.0.20619

2026年11月03日に「Dev.to」が公開したITニュース「Word.LineFormat lost 8 documented properties in Office.js 16.0.20619」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

Wordアドイン開発用のOffice.js更新で、Wordの図形枠線を扱うLineFormatから8つの公式プロパティが削除された。これにより、既存アドインは意図通り動かなくなる恐れがある。開発者は使用箇所の特定とコード修正が必要だ。

ITニュース解説

Wordアドイン開発において、利用できるAPI(Application Programming Interface)が突然変更されるという重要なニュースがあった。これは、Web技術を使ってWordの機能を拡張するプログラム、つまりWordアドインを開発する際に利用する「Office.js」というJavaScriptライブラリに関する出来事だ。Office.jsは、Wordの文書内容を操作したり、書式を設定したりするための「窓口」となるAPIを提供しており、開発者はこれを通じてWordの内部機能にアクセスする。

今回の問題の中心となったのは「Word.LineFormat」というオブジェクトだ。Wordの文書には、図形やテキストボックスなど様々な要素が存在するが、それらの「線」、つまりアウトラインの見た目を設定する情報を管理しているのが、このWord.LineFormatオブジェクトである。線の色、太さ、スタイル、矢印の形状といった、見た目を決定する様々な「プロパティ」と呼ばれる設定項目を持っている。プロパティとは、オブジェクトが持つ具体的な情報や設定値のことである。

Office.jsのバージョン16.0.20619が2023年10月30日に全面的に展開された際、このWord.LineFormatオブジェクトから八つの重要なプロパティが削除された。具体的には、線の両端に付く「矢印」の長さ、スタイル、幅に関するプロパティ(beginArrowheadLength、beginArrowheadStyle、beginArrowheadWidth、endArrowheadLength、endArrowheadStyle、endArrowheadWidth)と、線の「背景色」(backgroundColor)、そして線の「パターン」(pattern)というプロパティだ。これらは、アドインで図形やテキストボックスの線の書式を細かく制御するために利用されていた機能であった。

この変更がなぜ開発者にとって問題なのかというと、これらのプロパティは「WordApiDesktop 1.3」という機能セットの一部として、マイクロソフトの公式ドキュメントで「プロダクションAPI」つまり、実際の製品開発で利用できる安定したAPIとして明記されていたからだ。要件セットとは、特定のバージョンのOfficeアプリケーションで利用可能なAPIのグループを示すもので、開発者はこれを見て、自分たちのアドインがどのOfficeバージョンでどの機能を使えるかを判断する。しかし、公式に利用可能とされていた機能が、事前に何の予告もなく、しかもドキュメントにも非推奨の記載がないまま突然削除されたのである。これは、開発者が頼りとする「公式情報」の信頼性が揺らぐ、極めて深刻な事態を意味している。

この変更は、Windows版やMac版のデスクトップWordで動作するアドインに加えて、iOS版やWeb版のWordにも影響が及んだ。Office.jsファイルはCDN(Content Delivery Network)という、Webコンテンツを高速に配信するための世界中に分散されたネットワークを通じて提供されるため、一度更新されると、世界中のユーザー環境に影響が広がる。実際に、各プラットフォーム向けのOffice.jsファイルが更新され、削除が確認されている。

このプロパティの削除は、単なる名前の変更や一時的な非表示ではないことが、APIの変更点を分析する技術や、アーカイブされたOffice.jsファイルを直接調査することによって証明された。削除されたプロパティに関するコードはファイル内から完全に消え去り、WordのOffice.jsファイルは実際にサイズが減少していた。文字通り、コードがアプリケーションから「切り取られた」のである。

アドイン開発者が直面する具体的な影響は大きい。もしアドインが削除されたプロパティの値を「読み取ろう」とした場合、以前は値が返されていたところが、今では「undefined」(未定義)という結果が返ってくる。これはプログラムが予期しない結果であり、後続の処理でエラーや誤動作を引き起こす可能性がある。さらに危険なのは、削除されたプロパティに「値を書き込もう」とした場合だ。Office.jsのプロパティに値を設定する際、通常は「セッター」と呼ばれる特別な関数を通じてWordに変更が通知される。しかし、プロパティ自体がなくなってしまった場合、JavaScriptの通常の動作として、アドインプログラムの内部で一時的に新しいプロパティが作成されるだけで、Wordドキュメントに対しては一切の変更が反映されない。しかも、この際にはエラーが発生しないため、開発者は問題が起こっていないと誤解し、これが「沈黙の失敗」として最も厄介なケースである。

また、複数のプロパティをまとめて設定するset()メソッドを使用している場合も注意が必要だ。lineFormat.set({ endArrowheadStyle: ... })のように記述した場合、Wordのホスト環境によっては、削除されたプロパティが無視されるか、あるいはエラーがスローされるか、その挙動は一貫しない可能性がある。

このような事態に対処するため、開発者はまず自分のアドインのソースコードやビルドされたファイルの中に、削除されたプロパティを参照している箇所がないか、詳細に検索して確認すべきである。そして、もしこれらのプロパティに依存している部分が見つかった場合は、公式ドキュメントや要件セットの記述だけを盲信せず、プログラムが実行される環境でそのプロパティが実際に利用可能かどうかを、動的にチェックする処理を実装することが非常に重要となる。例えば、「"beginArrowheadStyle" in Word.LineFormat.prototype」のように記述することで、プロパティが存在するかどうかを事前に確認でき、予期せぬ問題の発生を回避できる可能性が高まる。

今回のAPI変更は、およそ3日間かけて段階的に展開された。この期間中、同じWord環境であっても、アドインが古いバージョンのOffice.jsを読み込むか、新しいバージョンを読み込むかが、利用するCDNサーバーによって変動し、線の書式が正しく適用されたり、されなかったりといった不安定な挙動が一時的に発生したことも示唆されている。WordのAPIは最近も変更が続いており、今回が単発の出来事ではないという指摘もある。

システムエンジニアを目指す皆さんにとって、このニュースは、API提供元が提供するドキュメントや情報が常に最新で正確であるとは限らないという現実を突きつける。安定しているはずのプロダクションAPIであっても、予告なく変更されるリスクがあることを常に意識し、そのような変化に対応できるような堅牢で柔軟なシステムを設計・開発する重要性を再認識する良い機会となるだろう。

関連コンテンツ

関連IT用語