Google Apps 脚本中的 getValues() 如何返回“未定义”值？

Question

I was trying to count the number of filled cells in a column and once it is empty, the count is supposed to stop. As such I imposed this condition:

sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Sheet1')
numberOfRows = 0
while(sheet.getRange(2,1,sheet.getLastRow()-1,1).getValues()[numberOfRows] != '') {
  numberOfRows ++
}

I turned on the debugger on Google Apps Script and found out that the above while loop did not stop. Upon further testing, I found that the cells that were empty were 'undefined', instead of the conventional empty string that they were supposed to return. Any possible reason that the cells could return an 'undefined' instead of ''?

Answer 1

The undefined values are not the issue, the loop is not finishing because each row is an Array, and an Array is never equal to ''.

When the code calls sheet.getRange(2,1,sheet.getLastRow()-1,1).getValues()[numberOfRows] the return value is an Array of columns. If you selected 3 columns in your range, a row would look something like: ['A','B','C'] .

To access the value of a column in the row, you need to specify it's index. In this case, you are only selecting a single columnm ( ['A'] ), so the index is 0.

Optionally, you might find the code is cleaner if you put the values in a variable first, this is a style choice.

  var values = sheet.getRange(2,1,sheet.getLastRow()-1,1).getValues();
  var numberOfRows = 0;

  while(values[numberOfRows][0] != '' ){
     numberOfRows++;
  }

Answer 2

The code has some problems:

1. as mentioned in a question's comment, it's not a good idea to use getValues() in a loop

2. the following expression can't be visualized in the Google Apps Script editor debugger

   sheet.getRange(2,1,sheet.getLastRow()-1,1).getValues()[numberOfRows]

3. the above expression returns an Array, not a single value.
4. the loop doesn't stops when the last row has been reached.

---

The assumption that getValues() returned undefined is wrong. That's is caused by numberOfRows having a value equal or greater than the number of elements returned by getValues() as JavaScript arrays indexes are zero based.

In order to able to use the Google Apps Script debugger you should add more code lines

var values = sheet.getRange(2,1,sheet.getLastRow()-1,1).getValues();

Regarding the

I was trying to count the number of filled cells in a column and once it is empty, the count is supposed to stop.

I think that a better wording is "find the first empty cell". Anyway, it should stop also when the last row of the the column is reached.

var numberOfRows = 0;
while(numberOfRows < values.length && values[numberOfRows][0] !== ''){
  numberOfRowss++;
}