Fusion 실험 및 내부용 함수
이 절의 함수는 Experimental로 분류됩니다. 입력과 반환값을 구분하여 기존 시트의 동작을 해석하거나 해당 기능을 구성할 때 사용합니다. 오류 생성과 I/O 차단 함수는 테스트 목적의 동작이므로 일반 업무 계산에 넣지 않습니다.
값의 태그
experimental_add_tags(value: any, tags: array): same_as_first_argument
experimental_get_tags(value: any): array
experimental_remove_tags(value: any, [tags: array]): same_as_first_argument
add_tags는 값에 태그 배열을 추가한 새 값을 반환합니다. get_tags는 값에 연결된 태그 배열을 가져옵니다. remove_tags는 지정한 태그를 제거하며 tags를 생략하면 모든 태그를 제거합니다.
시트와 내보내기 복사 버튼
experimental_copy_and_sync_button(
label: string,
folder: string,
name: string,
[exports: array],
[onCompleteMessage: string],
[onFailureMessage: string],
[redirectToHomeAfterCompletion: boolean]
): same_as_first_argument
label을 표시하는 버튼을 만들고 클릭하면 현재 스프레드시트를 folder에 name으로 복사합니다.
- 내보내기 복사 이름은
$name - Export $sheetName패턴을 사용합니다. - exports에 내보낼 시트 이름들을 지정하여 복사 대상을 제한할 수 있습니다. 요청한 내보내기가 하나라도 없으면 복사가 실패합니다.
- onCompleteMessage와 onFailureMessage로 완료 및 실패 메시지를 지정할 수 있습니다.
- redirectToHomeAfterCompletion이 true이면 완료 후 사용자의 홈 폴더로 이동합니다.
버튼 실행은 문서와 내보내기 복사본을 생성하므로 대상 폴더와 이름을 확인합니다.
오류 생성
experimental_error([value: string, ...]): any
지정한 문자열 인수로 오류를 출력합니다.
I/O 차단 테스트
experimental_io_blocking_function([extra_delay: number]): string
시간 초과까지 I/O를 막는 테스트 함수입니다. extra_delay로 시간 초과 후에도 추가로 기다리게 하여 정상적으로 응답하지 않는 I/O 동작을 모사할 수 있습니다.
범위 생성
experimental_range(width: number, [value: any, ...]): range
숫자 width와 값들을 받아 범위를 반환합니다.
내부 표 영역 결과
internal_region_result(region_id: string): any
문자열 region_id를 받는 내부용 함수입니다. 일반적인 시트 구성에는 셀 범위 참조나 표 영역을 사용합니다.