파일 처리를 사용하면 확장 프로그램이 파일 메뉴의 열기 메뉴 또는 컨텍스트 메뉴의 연결 프로그램 메뉴를 사용하여 파일을 열 수 있도록 ChromeOS를 구성할 수 있습니다. 파일이 열리면 웹 플랫폼의 Launch Handler API를 사용하여 파일의 데이터를 처리합니다. 그런 다음 표준 웹 플랫폼 API를 사용하여 파일을 표시하거나 처리합니다.
확장 프로그램에서 사용 가능 여부
ChromeOS 120 이상
권한
파일 처리에 권한이 필요하지 않습니다.
매니페스트
manifest.json 파일에 "file_handlers" 배열을 추가해야 합니다.
지원 컨텍스트
이 API는 확장 프로그램 서비스 워커, 팝업, 측면 패널 또는 콘텐츠 스크립트에서 사용할 수 있습니다.
파일 핸들러 구성
"file_handlers"의 각 멤버(파일 핸들러를 의미)는 특정 확장자 페이지에서 처리할 파일 형식을 지정합니다.
지정하는 핸들러는 ChromeOS 파일 창, 구체적으로는 메뉴와 함께 열기 및 열기에 추가됩니다. 사용자가 특정 확장자를 가진 파일을 선택한 경우에만 이러한 메뉴에 나타납니다. 예를 들어 파일 핸들러가 .txt을 지정하면 해당 확장자를 가진 파일이 선택된 경우에만 ChromeOS 메뉴에서 해당 핸들러를 표시합니다.
파일 처리
파일 핸들러는 확장 프로그램에 포함된 HTML 파일입니다. 사용자가 메뉴에서 핸들러를 선택하면 HTML 파일이 새 탭에서 열립니다. 파일을 표시하든 다른 방식으로 사용하든 파일은 적절한 웹 플랫폼 API를 사용하여 JavaScript로 처리합니다. 처리 코드는 별도의 JavaScript 파일에 있고 <script> 태그를 통해 포함되어야 하며 확장 프로그램에도 있어야 합니다. 스크립트 파일은 Launch Handler API의 LaunchQueue 인터페이스를 사용하여 FileSystemFileHandle 객체를 가져옵니다.
예
다음 예는 LaunchQueue 인터페이스를 사용하여 FileSystemFileHandle 객체를 가져오는 방법을 보여줍니다. 실제로 진행되는 파일 처리를 확인하려면 파일 처리 데모를 설치하세요.
if ('launchQueue' in window) {
launchQueue.setConsumer(async launchParams => {
if (!launchParams.files || !launchParams.files.length) { return; }
const fileHandle = launchParams.files[0];
});
}
``````