1. Office Scriptsとは？

Office Scriptsは、Excel Onlineで使えるExcel自動化の仕組みです。手作業で行っているセル入力や計算、シート操作を、あらかじめ書いたコードでまとめて実行できます。

Office ScriptsではTypeScriptという言語を使います。 TypeScriptの特徴の一つが「型注釈」を使えることです。これが、初心者でも失敗しにくい理由につながっています。

2. 型注釈（type annotation）とは何か

型注釈とは、「この変数には何が入るのか」をあらかじめ説明するための印です。人で言えば、名札のような役割をします。

たとえば「この箱には数字だけ入ります」「ここには文字だけです」と決めておくことで、間違った使い方を防げます。これがTypeScriptの型注釈です。

3. 変数に型注釈を付けてみよう

Office Scriptsでは、変数を使ってシートや数値、文字を扱います。型注釈を付けると、コードを書いている途中で間違いを教えてくれます。


function main(workbook: ExcelScript.Workbook) {
  const message: string = "型注釈の例";
  const sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  sheet.getRange("A1").setValue(message);
}

stringは文字を表す型です。 ExcelScript.Worksheetは、Excelのシートを表します。これにより、変数の役割が一目で分かります。

4. 型注釈があると何がうれしいのか

型注釈を使う最大のメリットは、ミスを事前に防げることです。たとえば、数字を入れる場所に文字を入れようとすると、すぐに警告が出ます。

Excelでいうと、「数値専用セルに文字を入力したら注意が出る」ような感覚です。プログラムが壊れる前に気付けるので、初心者でも安心して操作できます。

5. 関数の引数と戻り値の型注釈

型注釈は、変数だけでなく関数にも使えます。関数が何を受け取り、何を返すのかを明確にできます。


function getTitle(): string {
  return "Office Scripts入門";
}

この例では、「この関数は文字を返します」と宣言しています。 returnの結果と型が違うと、すぐにエラーとして教えてくれます。

6. Office Scripts特有の型注釈

Office Scriptsでは、Excel操作専用の型がたくさん用意されています。 Workbook、Worksheet、Rangeなどが代表例です。


function main(workbook: ExcelScript.Workbook) {
  const range: ExcelScript.Range = workbook
    .getActiveWorksheet()
    .getRange("B2");
  range.setValue(100);
}

型注釈を付けることで、「この変数はセル範囲です」と明確になります。 Excel操作の読み間違いを防ぐ効果があります。