ifやforEachの中で取得した変数の値が破棄されず、returnされるために必要な処理？

実現したいこと

最後のreturnで、message変数を返したい。

発生している問題・エラーメッセージ

getSheetMessage() の中で、「message」は問題なく得られているのですが、
呼び出し元の関数内のログで、
Logger.log("メッセージ取得なし")
が表示されてしまいます。取得されているはずの「message」が何らかの理由でreturnされていないようです。

該当のソースコード

Google
1function getSheetMessage() {
2  const ss = SpreadsheetApp.getActiveSpreadsheet();
3  const sh1 = ss.getSheetByName('data');  
4  const startRows = 2;  
5  const sheetData = sh1.getSheetValues(startRows, 1, sh1.getLastRow(), 
6  sh1.getLastColumn());  
7  const today = new Date();
8  
9  // シートの各行ごとにデータを取り出す
10  sheetData.forEach(function(value, index) {
11    if (new Date(value[0]).getTime() < today.getTime()) {
12      // sh1.getRange(startRows + index,3 ).setValue("済");
13      var message = sh1.getRange(startRows + index,2).getValue();
14      Logger.log(message) // 。。。ログ１
15     // return message;  //はじめ、ここにあったが、18行目に移動した
16     }
17   });
18  Logger.log("forEachの外の"+message)　//。。。ログ２
19  return message;
20}
21
22
23//return先の関数’（該当部分抜粋）
24　・・・
25
26 const message = getSheetMessage();
27  if (!message) 
28    {  
29      Logger.log("メッセージ取得なし");
30      return;
31    }
32
33  GmailApp.sendEmail("●●●@gmail.com",title,message);
34 
35

試したこと

●return が forEachやif文の中にあることがおかしいだろうと思い、現在の位置（19行目）に移しました。
●特に18行目（ログ２）で、messageが空になってしまっていることが確認できています。

ifまたはforEach内で取得した　message変数を、
その外にまで持っていくにはどのようにコードを書けばよいか？　
お教えいただきたいです。

＊追記：最初に変数を宣言していないためにうまくいかないのかと思い、下記画像３８行目のような宣言もしたのですが、やはり反応は同じでした。（コード内のLogger.logでは正常に取得できているが、最後のreturnでは返されない。）

どうぞよろしくお願い致します。

行動規範の内容に同意します

回答2件

ベストアンサー

質問内にある画像のコードで修正例を示します。（目視なので一部異なっているかもしれませんが）
下記7行目のように message を定義しているとして、forEach の中でmessage を使うときは、14行目のように var を削除してみてください。

js
1function getSheetMessageAndPrintDone() {
2  const ss = SpreadsheetApp.getActiveSpreadsheet();
3  const sh1 = ss.getSheetByName('bot');  
4  const startRows = 2; // 開始行数
5  const sheetData = sh1.getSheetValues(startRows, 1, sh1.getLastRow(),  sh1.getLastColumn());  // シートのデータを取得
6  const today = new Date();
7  var message = '';
8  
9  // シートの各行ごとにデータを取り出す
10  sheetData.forEach(function(value, index) {
11    if (!value[2] && new Date(value[0]).getTime() < today.getTime()) {
12      // sh1.getRange(startRows + index,3 ).setValue("済");
13      // var message = sh1.getRange(startRows + index,2).getValue
14      message = sh1.getRange(startRows + index,2).getValue(); // <- var を削除した
15      Logger.log(message)
16     // return message;
17     }
18   });
19  Logger.log("forEachの外の"+message)
20  return message;
21}