先生と生徒の会話形式で理解しよう

生徒

「Office Scriptsを書いていると、エラーが出たり、何を書いているのか分からなくなったりします……。」

先生

「それは型注釈を使っていないからかもしれません。TypeScriptでは型注釈を使うと、コードがとても分かりやすくなります。」

生徒

「型注釈って何ですか？難しそうな名前で不安です。」

先生

「Excelでいうと、セルに数字を入れるか文字を入れるかを決めるラベルのようなものです。一緒にゆっくり見ていきましょう。」

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操作の読み間違いを防ぐ効果があります。