Docs › Reference

Error and warning codes

Codes and messages for password, corruption, format, header and row errors, and personal data, macro and hidden content warnings.

The errors and warnings of check() and the issues of inspect() hold { code, severity, message, …values }. Messages are English by default and Korean with locale: 'ko'. Placeholders such as {max} are filled in, and the same values are fields on the object.

{ code: 'HEADER_MISMATCH', severity: 'error', message: 'Column B: expected "전화번호", found "연락처"',
  col: 'B', expected: '전화번호', actual: '연락처' }

Code	Severity	Message (en)	Message (ko)
`PASSWORD_PROTECTED`	error	File is password protected	암호가 걸린 파일입니다
`ENCRYPTED_DEFAULT_PASSWORD`	error	File is protected by Excel's built-in password; re-save the file without protection	엑셀 기본 암호로 보호된 파일입니다. 보호를 해제하고 다시 저장해 주세요
`CORRUPTED`	error	File is corrupted or cannot be read	파일이 손상되었거나 읽을 수 없습니다
`UNSUPPORTED_FORMAT`	error	Unsupported file format (reason: 'too old') Unsupported file format (too old)	지원하지 않는 파일 형식입니다 (reason: 'too old') 지원하지 않는 파일 형식입니다 (너무 오래된 버전)
`FILE_TOO_LARGE`	error	File is larger than {max} (over maxCells) File has more than {maxCells} cells	파일이 {max}보다 큽니다 (maxCells를 넘을 때) 칸이 {maxCells}개를 넘는 파일입니다
`EMPTY_FILE`	error	File has no data	파일에 데이터가 없습니다
`FORMAT_NOT_ALLOWED`	error	{format} files are not allowed	{format} 파일은 사용할 수 없습니다
`SHEET_NOT_FOUND`	error	Sheet "{name}" not found	"{name}" 시트를 찾을 수 없습니다
`COLUMN_COUNT`	error	Expected {expected} columns, found {actual}	열이 {expected}개여야 하는데 {actual}개입니다
`HEADER_MISMATCH`	error	Column {col}: expected "{expected}", found "{actual}" (only spacing or case differs) Column {col}: expected "{expected}", found "{actual}" (same name with different spacing or case?)	{col}열: "{expected}"이어야 하는데 "{actual}"입니다 (공백·대소문자만 다를 때) {col}열: "{expected}"이어야 하는데 "{actual}"입니다 (띄어쓰기나 대소문자만 다른 건 아닌가요?)
`HEADER_ORDER`	error	"{name}" should be column {expected}, found at column {actual}	"{name}"은(는) {expected}열에 있어야 하는데 {actual}열에 있습니다
`ROWS_TOO_FEW`	error	Expected at least {n} rows, found {actual}	행이 최소 {n}개 필요한데 {actual}개입니다
`ROWS_TOO_MANY`	error	Expected at most {n} rows, found {actual}	행이 최대 {n}개까지 가능한데 {actual}개입니다
`TEMPLATE_LOAD_FAILED`	error	Could not load template file	양식 파일을 불러오지 못했습니다
`CELL_ERRORS`	warning	{count} cells contain errors (first: {first})	오류가 있는 셀이 {count}개 있습니다 (첫 번째: {first})
`PERSONAL_DATA`	warning	Possible resident registration numbers in {count} cells	주민등록번호로 보이는 값이 {count}개 셀에 있습니다
`HAS_MACROS`	warning	File contains macros	매크로가 포함된 파일입니다
`HIDDEN_CONTENT`	warning	File has hidden sheets, rows or columns	숨겨진 시트, 행 또는 열이 있습니다
`MERGED_HEADER`	warning	Header row has merged cells	머리글 행에 병합된 셀이 있습니다
`EXTENSION_MISMATCH`	warning	File extension is .{ext} but content is {format}	확장자는 .{ext}인데 실제 내용은 {format}입니다
`RAGGED_ROWS`	warning	Some rows have a different number of cells than the header	머리글과 셀 개수가 다른 행이 있습니다
`DUPLICATE_HEADER`	warning	Duplicate column name "{name}"	"{name}" 열 이름이 중복되었습니다

PASSWORD_PROTECTED, ENCRYPTED_DEFAULT_PASSWORD, CORRUPTED, UNSUPPORTED_FORMAT, FILE_TOO_LARGE, EMPTY_FILE and SHEET_NOT_FOUND mean the file (or sheet) cannot be read, so the check stops there.

Warnings do not affect ok. Warnings listed in failOn, e.g. failOn: ['PERSONAL_DATA'], become errors; on the web component, strict-warnings promotes every warning. To change the wording, register the same keys with registerLocale(name, messages) (Function API).