파일 처리 기능을 사용하면 확장 프로그램이 파일 메뉴의 '열기' 메뉴 또는 컨텍스트 메뉴의 '연결 프로그램' 메뉴를 사용하여 파일을 열 수 있도록 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];
});
}
``````