clearRowsByConditional

function clearRowsByConditional(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  predicate: RowPredicate,
  options: RowConditionalOptions | null | undefined = {}
): number;

Вміст зникає, рядки лишаються, тому позиції не зсуваються і все, що посилається на рядок за номером, далі вказує на те саме місце. Видаляє рядки deleteRowsByConditional.

Аркуш читається один раз, а очищення групується в суміжні блоки, тому навіть розрізнена вибірка коштує небагатьох звернень до сервісу.

Аркуш означає весь його діапазон даних; діапазон — лише свої клітинки, решта аркуша не читається й не чіпається. В обох випадках предикат отримує позицію на аркуші, тож рядок зберігає свій справжній номер.

Параметри

Параметр	Тип	Опис
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Аркуш, з яким працюємо, або діапазон, усередині якого працюємо: читаються лише його клітинки, і очищаються лише вони.
`predicate`	`RowPredicate`	Отримує комірки рядка, його позицію від одиниці та — якщо задано `headerRow` — рядок із ключами за іменами стовпців. Поверніть `true` для рядків, з якими треба щось зробити.
`options` (необов'язковий) `= {}`	`RowConditionalOptions \\| null \\| undefined`	`headerRow` вказує рядок з іменами стовпців. Якщо його задано, кожен рядок приходить із ключами за цими іменами, а сам рядок заголовків вибуває з кандидатів.

Повертає

number — скількох це торкнулося.

Винятки

Виняток	Умова
`InvalidSheetException`	перший аргумент не є ні аркушем, ні діапазоном.
`IllegalArgumentException`	предикат не функція або позиція заголовка не додатне ціле.

Приклади

Застосування

const sheet = SpreadsheetApp.getActiveSheet();

clearRowsByConditional(sheet, (values, position, row) => row.status === "done", {
  headerRow: 1
});

Усередині одного блоку

const sheet = SpreadsheetApp.getActiveSheet();

// Only B2:D100 is read, and only those cells are cleared.
clearRowsByConditional(sheet.getRange("B2:D100"), (values) => values.every((cell) => cell === ""));

Дивіться також

Вихідний код

src/appsscript/sheet/clearRowsByConditional.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.