💾app.sheetByName()

GAS ⟩ app ⟩ methods ⟩ sheetByName()

💾 程式

• ⬆️ 需要： app.sheet.prototype

  // 🔸 app.sheetByName()
  sheetByName(name) {

    const ss = app.spreadsheet;
    let sheet = ss.getSheetByName(name);

    // if no such sheet, append a new one.
    if(sheet === null){ 
      let i = ss.getNumSheets();          // 目前的有幾頁
      sheet = ss.insertSheet(name, i);    // 插入最後面 (⭐️ will activate automatically)
    }

    sheet.activate();                     // ⭐️ activate before returning        
    sheet.__proto__ = app.sheetPrototype; // ⭐️ extend sheet 
    return sheet;
  },

📘 手冊

• Spreadsheet ⟩

  • getSheetByName()

  • getNumSheets()

  • insertSheet()

• Sheet ⟩

  • activate()

🧨 雷區

🧨 雷區：

• sheet.activate() 回傳的物件竟然不是原來的 sheet❗️❗️❗️

• 但兩者實際上還是指向同一個試算表頁面，怪❗️

sheet === sheet.activate()        // false ❗️❗️❗️