문서 › 레퍼런스

오류·경고 코드표

암호, 손상, 형식, 머리글, 행 수 오류와 개인정보·매크로·숨김 경고의 코드와 메시지.

check()의 errors/warnings 와 inspect()의 issues 에는 { code, severity, message, …값 } 이 들어 있습니다. 기본 메시지는 영어이고 locale: 'ko' 로 한국어가 됩니다. {max} 같은 자리에는 실제 값이 들어가고, 같은 값이 객체의 필드로도 붙습니다.

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

코드	종류	메시지(en)	메시지(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, SHEET_NOT_FOUND 은 파일(또는 시트)을 읽을 수 없다는 뜻이라 검사가 거기서 끝납니다.

경고는 ok 에 영향이 없습니다. failOn: ['PERSONAL_DATA'] 처럼 지정한 경고는 오류가 되고, 웹 컴포넌트에서는 strict-warnings 속성이 모든 경고를 오류로 올립니다. 메시지를 바꾸려면 registerLocale(name, messages) 로 같은 키를 등록하세요(함수 API).