ExcelのOffice Script でJSONをパースしようとしたが正常に動作しない

Question

Office Scriptにて以下のようなJSONの文字列をセルから取得し、パースしようとしたのですが、JSON Parse error: Unrecognized token '\'というエラーが発生してしまい、うまく動作しませんでした。
どのように対処すればよいのでしょうか？

\n{"a": "test", "b": "test"}

コード内で直接JSONの文字列を扱った場合には問題なく動作したのですが、ExcelのセルからJSONの文字列を取得したうえでJSONパースを行うとうまく動作しないようです...
なおJSONの文字列に\nが含まれない場合はセルから取得するか否かに関わらず、正常に動作しました
\nに原因がありそうです

// うまくいったパターン
function main(workbook: ExcelScript.Workbook) {
    const parsedText = JSON.parse(`\n{"a": "test", "b": "test"}`) as string;
    console.log(parsedText)
}

// うまくいかなかったパターン
function main(workbook: ExcelScript.Workbook) {
    const sheet = workbook.getActiveWorksheet();
    const cellValue = sheet.getRange("A1").getText();
    const parsedText = JSON.parse(cellValue) as string;
    console.log(parsedText)
}

Answer 1

文字列リテラルの中での\nは「改行」を表し、「改行」は「うまくいったパターン」でお書きのその場所にあってもJSON的には無視されるだけです。
エラーメッセージからすると、セルの中の先頭には「改行」でなく\nという文字列をそのまま書いちゃっているのでしょうね。
それだとJSONじゃないので、JSONとしてパースしようとするとそういうエラーになります。
「うまくいったパターン」の\nを\\nに書き換えると、「改行」でなく「\nという文字列」になるので「うまくいかなかったパターン」と同じエラーになります。

暫定対応(対症療法)としては、
「前段処理の都合で、セルの先頭に\nという文字列が入ることがある」なら、「セル先頭の\nを削除してからパースする」でしょう。
あるいは「セルのあちこちに改行のつもりの\nが入っている。それ以外には\nは無い」なら、「セル内すべての\nを削除してからパースする」でしょうが、「セルのあちこちに改行のつもりの\nが入っている。それ以外にJSON内の文字列リテラルの中にもJSONとして正当な\nはある」だと、JSONとして不正な\nと正当な\nを見分けないといけないので面倒です。

本格対応としては、
前段処理を修正して、セル内にJSONとして不正な\nという文字列が入ることが無いようにすることです。

Comments

[maimai]

ご回答ありがとうございます！

おっしゃる通り、\nを削除してパースしてみたところ、正常に動くようになりました！

1つだけ確認させていただきたいのですが、Excelのセル上で `\n`と表記されていた場合、それは内部的には（という表現が適切かはわかりませんが...）`\\n`というデータとして扱われているという認識で間違いないでしょうか？

[otn]

> Excelのセル上で `\n`と表記されていた場合

その場合、内部的には「\」と「n」とからなる2文字です。
各種プログラミング言語では、文字列リテラルの中に「\」を書くときは「\\」と書くことになっている文法が普通です。Office Scriptもそうです。そこでは『「\」と「n」とからなる2文字』は、「\\n」と書きます。それらのプログラミング言語では文字列リテラルの中に「\n」と書くと、「\」と「n」とからなる2文字ではなくて、「改行を表す1文字(文字コードは16進だと0A、10進で10)」を意味します。
こういうのは、プログラミングにきちんと入門すると、最初の方で学ぶはずです。

データの中身（内部表現）と、それをプログラムの文字面でどう書くかは別の話です。