선택된 표시 모드 결정

다음 단계는 웹 앱의 선택된 표시 모드 결정에서 [=application manifest/processing extension-point=]에 추가되며, 이제 선택적인 [=URL=] |document URL|도 받는다:

1. |manifest:ordered map|의 [=manifest/display_override=] 멤버의 각 |entry:display override entry|에 대해 [=list/For each=]:
   1. |candidate display mode|를 null로 둔다.
   2. |entry|가 [=display mode=]인 경우:
      1. |candidate display mode|를 |entry|로 설정한다.
   3. 그렇지 않고 |entry|가 [=DisplayOverrideEntryObject=]인 경우:
      1. |entry|의 [=DisplayOverrideEntryObject/url_patterns=]가 [=list/is empty=]이면:
         1. |candidate display mode|를 |entry|의 [=DisplayOverrideEntryObject/display=]로 설정한다.
      2. 그렇지 않고 |document URL|이 null이 아니면:
         1. |entry|의 [=DisplayOverrideEntryObject/url_patterns=]의 각 |pattern|에 대해 [=list/For each=]:
            1. |pattern|이 |document URL|과 [=URL pattern/matches=]하면, |candidate display mode|를 |entry|의 [=DisplayOverrideEntryObject/display=]로 설정하고 [=iteration/break=]한다.
   4. |candidate display mode|가 null이면, [=iteration/continue=]한다.
   5. 표시 모드 목록이 |candidate display mode|를 포함하면, 그 |candidate display mode|를 반환한다.
   6. |candidate display mode|가 [=display mode/window-controls-overlay=]이고 [=user agent=]가 이를 지원하면, 그 |candidate display mode|를 반환한다.
   7. |candidate display mode|가 [=display mode/tabbed=]이고 [=user agent=]가 이를 지원하면, 그 |candidate display mode|를 반환한다.
   8. |candidate display mode|가 [=display mode/unframed=]이고, [=user agent=]가 이를 지원하며, 애플리케이션이 Isolated Web Application [[isolated-web-apps]]이면, 그 |candidate display mode|를 반환한다.

`display_override` 멤버 처리

[=ordered map=] |json:ordered map|, [=ordered map=] |manifest:ordered map|, 그리고 [=URL=] |manifest URL:URL|이 주어졌을 때 `display_override` 멤버를 처리하려면, 다음을 실행한다:

1. |manifest|["display_override"]를 새 [=list=]로 설정한다.
2. |json|["display_override"]가 [=map/exist=]하지 않으면 반환한다.
3. |json|["display_override"]가 [=list=]가 아니면 반환한다.
4. |processed display override:list|를 새 [=list=]로 둔다.
5. |json|["display_override"]의 각 |entry|에 대해 [=list/For each=]:
   1. |entry|가 [=string=]인 경우:
      1. 표시 모드 목록 ([=display mode extensions|extensions=] 포함)이 |entry|를 포함하면, |entry|를 |processed display override|에 [=list/append=]한다.
   2. 그렇지 않고 |entry|가 [=ordered map=]인 경우:
      1. |entry|["display"]가 [=map/exist=]하지 않거나 [=string=]이 아니면, [=iteration/continue=]한다.
      2. 표시 모드 목록 ([=display mode extensions|extensions=] 포함)이 |entry|["display"]를 포함하지 않으면, [=iteration/continue=]한다.
      3. [=user agent=]가 |entry|["display"]에 대한 URL 패턴을 지원하지 않으면, [=iteration/continue=]한다.
      4. [=DisplayOverrideEntryObject/display=]가 |entry|["display"]로 설정된 새 [=DisplayOverrideEntryObject=]인 |override object|를 둔다.
      5. |entry|["url_patterns"]가 [=map/exists=]하는 경우:
         1. |entry|["url_patterns"]가 [=list=]가 아니면, [=iteration/continue=]한다.
         2. |entry|["url_patterns"]의 각 |pattern entry|에 대해 [=list/For each=]:
            1. |pattern:URL pattern|을 |pattern entry|와 |manifest URL|이 주어졌을 때 [=build a URL pattern from an infra value=]의 결과로 둔다. 이 과정이 예외를 던지거나 null을 반환하면, [=iteration/continue=]한다.
            2. |pattern|을 |override object|의 [=DisplayOverrideEntryObject/url_patterns=]에 [=list/append=]한다.
      6. |override object|를 |processed display override|에 [=list/append=]한다.
6. |manifest|["display_override"]를 |processed display override|로 설정한다.

개념

• 창 컨트롤: 사용자가 애플리케이션을 제어하기 위한 특정 동작을 수행할 수 있도록 운영 체제가 애플리케이션 전반에서 일관되게 사용하는 인터페이스 요소. [=window controls=]의 일반적인 동작에는 최소화, 최대화/복원, 닫기 버튼이 포함된다.
• 창 프레임: 애플리케이션 창의 웹 콘텐츠를 둘러싸는, 테두리, 제목 표시줄, 창 컨트롤을 포함한 호스트 네이티브 장식.

표시 모드 확장

일반 표시 모드에 더하여, [=manifest/display_override=]는 특정 표시 모드 확장도 지원한다.

[=display mode/unframed=]

앱 창은 [=display mode/unframed=]이며, 이는 [=Window frame=]이 없음을 의미한다. 호스트 네이티브 제목 표시줄이 없고, [=window controls=]도 보이지 않는다. 웹 콘텐츠는 전체 창 영역으로 확장된다. [=display mode/Unframed=]는 [[[isolated-web-apps]]]로 제한된다.

[=display mode/window-controls-overlay=]

앱 창은 일반 [=window controls=] 대신 [=display mode/window-controls-overlay=]를 가진다.

tabbed

웹 애플리케이션은 여러 [=application contexts=]를 하나의 운영 체제 수준 창 안에 결합할 수 있다. 예를 들어, 이는 사용자 에이전트가 사용자가 애플리케이션 컨텍스트 사이를 전환할 수 있도록 탭 스트립 UI를 표시한다는 의미일 수 있다.

            {
              "name": "Recipe Zone",
              "description": "All of the recipes!",
              "icons": [{
                "src": "icon/hd_hi",
                "sizes": "128x128"
              }],
              "start_url": "/index.html",
              "display_override": ["minimal-ui"],
              "display": "standalone",
              "theme_color": "yellow",
              "background_color": "red"
            }
          

unframed 표시 모드

[=display mode/unframed=] 표시 모드는 [[[isolated-web-apps]]]가 제목 표시줄 영역을 포함하여 앱 창의 외형을 완전히 제어할 수 있게 한다.

[=display mode/unframed=]인 창에는 호스트 네이티브 제목 표시줄이나 [=window controls=]가 보이지 않으며, 웹 콘텐츠는 전체 창 영역으로 확장된다. 앱은 웹 콘텐츠 안에 [=draggable regions=]를 지정하여 사용자 정의 제목 표시줄을 만들 수 있다.

[=User agents=]는 [=display mode/unframed=]의 사용을 [[[isolated-web-apps]]]로 제한해야 한다(MUST).

[=display mode/unframed=] 창이 생성되면, 그 표시 모드는 창의 수명 동안 고정된다. [=user agent=]는 범위 밖 URL로의 탐색이 unframed 창 안에서 일어나도록 허용해서는 안 된다(MUST NOT).

시각적 예

다음 그림들은 표준 웹 애플리케이션 창과 [=display mode/unframed=] 표시 모드를 활용하는 창 사이의 시각적 차이를 보여준다. 일반 앱 창(왼쪽)은 호스트 네이티브 제목 표시줄과 표준 창 컨트롤을 포함한다. 반대로, unframed 앱 창(오른쪽)은 이러한 호스트 제공 프레임 장식을 제거하여 웹 콘텐츠가 전체 창 영역을 차지할 수 있게 한다.

            @media (display-mode: unframed) {
              /* styles for unframed mode */
            }
          

드래그 가능한 영역 정의

`app-region` 속성은 예를 들어 제목 표시줄의 어떤 영역이나 요소가 드래그 가능한지를 CSS로 정의하는 데 사용할 수 있다.

• 요소를 드래그 가능하게 하려면, `drag`로 설정해야 한다.
• 요소의 드래그를 비활성화하려면, `no-drag`로 설정해야 한다.

`app-region` 속성은 창에 적용된 [=display mode=]가 [=display mode/unframed=] 또는 [=display mode/window-controls-overlay=]인 경우에만 효과를 가져야 한다(MUST).

home_tab 멤버

[=tab_strip=] 객체의 `home_tab` 멤버는 애플리케이션의 최상위 메뉴 역할을 하도록 의도된 특별한 "홈 탭"에 대한 정보를 포함하는 순서 있는 맵이다. 이는 다음 멤버를 포함한다:

• [=home_tab/scope_patterns=]

scope_patterns 멤버는 [=manifest URL=]을 기준으로 [=within home tab scope|홈 탭의 범위=]를 정의하는 {{URLPatternInput}}의 목록이다.

애플리케이션에 적용된 [=display mode=]가 [=display mode/tabbed=]이고, [=Document/processed manifest=]가 [=tab_strip=] 멤버의 null이 아닌 [=home_tab=] 멤버를 포함하면, 그 애플리케이션은 홈 탭을 가진다.

홈 탭 컨텍스트는 다른 애플리케이션 컨텍스트와 비교하여 특별한 속성을 가지는 선택적 [=application context=]이다. 애플리케이션이 [=has a home tab=]이면, 모든 애플리케이션 창은 [=home tab context=]를 포함하는 것이 좋다(SHOULD). 그렇지 않으면, 애플리케이션 창은 [=home tab context=]를 가져서는 안 된다(SHOULD NOT).

[=home tab context=]가 어떻게 표시되는지는 사용자 에이전트의 재량에 달려 있지만, 일반 애플리케이션 컨텍스트와 다른 외형을 가지는 것이 좋다(SHOULD).

[=URL=] |url:URL|은 다음 경우에, 그리고 그 경우에만 홈 탭 범위 내에 있다고 한다:

• 애플리케이션이 [=has a home tab=]이고,
• |url|이 매니페스트의 [=manifest/within scope=]이며,
• 다음 중 적어도 하나가 참이다:
  • |url|이 [=start URL=]과 [=URL/equals=]하며, [=URL/equals/exclude fragments=]가 true로 설정되어 있거나,
  • [=Document/processed manifest=]의 [=tab_strip=] 멤버의 [=home_tab=] 멤버의 [=scope_patterns=] 멤버의 임의 요소와 |url|이 주어졌을 때 [=URL pattern/match=]를 적용하면 {{URLPatternResult}}를 반환한다.

URL은 [=within home tab scope=]가 아니면 홈 탭 범위 밖이다.

new_tab_button 멤버

[=tab_strip/new_tab_button=] 멤버는 클릭/활성화될 때 애플리케이션 창 안에서 새 [=application context=]를 여는 UI 어포던스(예: 버튼)의 동작을 설명하는 순서 있는 맵이다. 이는 다음 멤버를 가진다:

• [=new_tab_button/url=]

url 멤버는 [=Document/processed manifest=]의 [=manifest/within scope=]인 [=manifest URL=] 기준의 URL을 나타내는 문자열이다.

[=Document/processed manifest=]의 [=new_tab_button=]의 [=new_tab_button/url=] 멤버가 [=outside of home tab scope=]이면, 애플리케이션은 새 탭 버튼을 가진다. 애플리케이션이 [=has a new tab button|새 탭 버튼을 가지지 않으면=], 사용자 에이전트는 "새 탭" 어포던스를 최종 사용자에게 제공하지 않는 것이 좋다(SHOULD NOT).

새 탭 버튼이 최종 사용자에 의해 활성화되면, 다음 단계가 실행된다:

1. 현재 창 안에 [=Create a new application context=]하고 포커스한다.
2. 이를 [=new_tab_button=]의 [=new_tab_button/url=] 멤버 값으로 탐색한다.

`tab_strip` 멤버 처리

[=ordered map=] |json:ordered map|, [=ordered map=] |manifest:ordered map|, 그리고 [=URL=] |manifest URL:URL|이 주어졌을 때 `tab_strip` 멤버를 처리하려면, [=processing a manifest=]의 확장 지점에서 다음을 실행한다:

1. |manifest|["tab_strip"]를 새 [=ordered map=]로 설정한다.
2. |json|["tab_strip"]가 존재하지 않거나 |json|["tab_strip"]가 [=ordered map=]가 아닌 경우:
   1. |manifest|["tab_strip"]["new_tab_button"]["url"]를 |manifest|["start_url"]로 설정한다.
   2. 반환한다.
3. |json|["tab_strip"], |manifest|["tab_strip"], 그리고 |manifest URL|을 전달하여 [=`home_tab` 멤버를 처리=]한다.
4. |json|["tab_strip"], |manifest|["tab_strip"], |manifest URL|, 그리고 |manifest|["start_url"]를 전달하여 [=`new_tab_button` 멤버를 처리=]한다.

new_note_url 멤버

[=note_taking=] `new_note_url` 멤버는 사용자가 웹 애플리케이션을 사용하여 새 note를 작성하려고 할 때(예: 운영체제 바로 가기 아이콘이나 키보드 단축키에서) 개발자가 사용자 에이전트가 로드하기를 선호하는 URL을 나타내는 [=string=]이다.

`new_note_url` 멤버는 순수하게 권고적인 것이며, 사용자 에이전트는 이를 무시하거나 최종 사용자에게 사용할지 여부를 선택하게 할 수 있다(MAY). 사용자 에이전트는 최종 사용자에게 이를 수정할 선택권을 제공할 수 있다(MAY).

`note_taking` 멤버 처리

[=ordered map=] |json:ordered map|, [=ordered map=] |manifest:ordered map|, [=URL=] |manifest_URL:URL|가 주어졌을 때 process the `note_taking` member하려면, [=processing a manifest=]의 extension point 중에 다음을 실행한다:

1. |json|["note_taking"]이 [=map/exist=]하지 않으면, 반환한다.
2. |json|["note_taking"]의 타입이 [=ordered map=]이 아니면, 반환한다.
3. |manifest|["note_taking"]을 새 [=ordered map=]으로 설정한다.
4. |json|["note_taking"], |manifest|["note_taking"] 및 |manifest URL|을 전달하여 [=process the `new_note_url` member=]를 수행한다.

`new_note_url` 멤버 처리

[=ordered map=] |json_note_taking:ordered map|, [=ordered map=] |manifest_note_taking:ordered map|, [=URL=] |manifest_URL:URL|가 주어졌을 때 process the `new_note_url` member하려면, 다음을 실행한다:

1. |json_note_taking|["new_note_url"]이 [=map/exist=]하지 않으면, 반환한다.
2. |json_note_taking|["new_note_url"]의 타입이 [=string=]이 아니면, 반환한다.
3. |new_note_url:URL|을 |manifest URL|을 base URL로 하여 |json_note_taking|["new_note_url"]을 [=URL Parser|파싱=]한 결과로 둔다.
4. |new_note_url|이 failure이면, 반환한다.
5. |new_note_url|이 |manifest URL|의 [=manifest/within scope=]가 아니면, 반환한다.
6. manifest_note_taking["new_note_url"]을 |new_note_url|로 설정한다.

`new_note_url` 실행

processed manifest |manifest:processed manifest|가 주어졌을 때 launch the `new_note_url`하려면, 다음 단계를 실행한다:

1. |manifest|["note_taking"]이 [=map/exist=]하지 않으면, 반환한다.
2. |manifest|["note_taking"]["new_note_url"]이 [=map/exist=]하지 않으면, 반환한다.
3. |manifest|["note_taking"]["new_note_url"]의 타입이 [=URL=]이 아니면, 반환한다.
4. |manifest|를 |manifest|로, |target URL|을 |manifest|["note_taking"]["new_note_url"]로 설정하여 [=launch a web application=] 단계를 실행한다.

사용자 에이전트는 주어진 [=installed web application=]에 대해 언제든지, 일반적으로 사용자 affordance에 대한 응답으로 [=launch the `new_note_url`=]할 수 있다(MAY).

`protocol_handlers` 멤버 처리

[=object=] |json:JSON|, |manifest:ordered map|가 주어졌을 때 process the `protocol_handlers` member하려면:

1. |processedProtocolHandlers|를 |json:JSON|["|protocol_handlers|"]의 새 [=list=]로 둔다.
2. manifest["|protocol_handlers|"]를 |processedProtocolHandlers|로 설정한다.
3. 각 |protocol_handler| (protocol handler description)에 대해 [=list/For each=]:
   1. |protocol_handler|["protocol"] 또는 |protocol_handler|["url"]가 undefined이면, [=iteration/continue=]한다.
   2. (|normalizedProtocol:string|, |normalizedUrl:URL|)을 |manifest URL|을 base URL로 하고 [=this=]의 relevant [=environment settings object=]를 사용하여 |protocol_handler|["protocol"], | protocol_handler|["url"]로 [=normalize protocol handler parameters=]를 실행한 결과로 둔다. 결과가 failure이면, [=iteration/continue=]한다.
   3. |normalizedUrl|이 |manifest|의 [=manifest/within scope=]가 아니면, [=iteration/continue=]한다.
   4. |processedProtocolHandlers|가 |normalizedUrl|을 [=list/contains=]하면, [=iteration/continue=]한다.
   5. |protocol_handler|를 |processedProtocolHandlers|에 [=List/Append=]한다.
4. |processedProtocolHandlers|의 각 항목에 대해 [=list/For each=], 사용자 에이전트는 [=register a protocol handler=]해야 한다(SHOULD).

사용자 에이전트는 host 운영체제에서 protocol의 기본 handler로 [=protocol handler description=] protocol_handler들을 등록하기 전에 사용자에게 권한을 요청해야 한다(SHOULD). 사용자 에이전트는 host 운영체제의 관례나 제한과 일관되게 유지하기 위해 표시되는 [=protocol handler description=] protocol_handlers 목록을 잘라낼 수 있다(MAY).

Protocol handler 항목

각 protocol handler description은 웹 애플리케이션이 처리하려는 protocol을 나타내는 [=object=]이며, [=manifest/protocol_handlers=] 멤버에 대응한다. 다음 멤버들을 가진다:

• [=protocol handler description/protocol=]
• [=protocol handler description/url=]

사용자 에이전트는 이러한 값을 사용하여 웹 애플리케이션을 운영체제에 handler로 등록해야 한다(SHOULD). 사용자가 protocol handler URL을 활성화하면, 사용자 에이전트는 handling a protocol launch를 실행해야 한다(SHOULD).

개인정보 고려 사항: 기본 protocol handler

운영체제의 기능에 따라, protocol handler는 사용자의 명시적 인지 없이 주어진 protocol의 'default' handler(예: 주어진 protocol의 실행을 자동으로 처리)가 될 수 있다. 가능한 오용을 방지하기 위해, 사용자 에이전트는 다음과 같은 보호 조치를 사용할 수 있다(MAY):

• [=invoke a protocol handler=] 과정을 실행하기 전에 명시적 사용자 동의를 요구한다.
• 위 dialog에 대한 응답 또는 사용자 조작으로, 웹 애플리케이션의 OS protocol handling entity 등록을 제거한다.
• [=installation=] 시 protocol handler 등록을 확인한다.

사용자 에이전트가 protocol handler entity의 등록을 제거하는 경우, 사용자가 웹 앱과 protocol을 운영체제에 다시 등록할 수 있는 UX를 제공해야 한다(SHOULD).

File Handler 항목

각 file handler는 자신이 수락하는 [=file types=]로 실행을 처리할 수 있는 애플리케이션 scope 내의 URL을 나타낸다. 다음 멤버들을 가진다:

• [=file handler/action=]
• [=file handler/name=]
• [=file handler/accept=]
• [=file handler/icons=]

사용자 에이전트는 이러한 멤버를 사용하여 웹 애플리케이션을 운영체제의 [=file type=]과 연결할 수 있다.

file type은 [=MIME type=] 및/또는 [=file extension=]으로 정의될 수 있다. OS가 파일에 [=MIME type=]이 있다고 판단하거나 그 이름이 특정 [=file extension=]으로 끝나는 경우, 파일은 file type에 속한다. file extension은 "."로 시작하고 valid suffix code points만 포함하는 문자열이다. 또한 [=file extensions=]는 16 code points 길이로 제한된다.

File handler 항목 처리

[=ordered map=] |item:ordered map|, [=URL=] |start_url:URL|, [=URL=] |scope:URL| 및 [=URL=] |manifest URL:URL|가 주어졌을 때 process a file handler item하려면:

1. 다음 중 하나라도 참이면 failure를 반환한다:
   • |item|["action"]이 [=map/exist=]하지 않거나 [=string=]이 아니다.
   • |item|["accept"]가 [=map/exist=]하지 않는다.
   • |item|["accept"]가 [=dictionary=]가 아니다.
   • |item|["accept"]가 [=map/is empty=]이다.
2. |url:URL|을 |manifest_url URL|을 base URL로 하여 |item|["action"]을 [=URL Parser|파싱=]한 결과로 둔다.
3. |url|이 failure이면, failure를 반환한다.
4. |url|이 |scope|의 [=manifest/within scope=]가 아니면, failure를 반환한다.
5. |launch_type:string|을 "single-client"로 초기화된 새 [=string=]으로 둔다.
6. |item|["launch_type"]이 [=map/exists=]하고 "multiple-clients"이면, |launch_type|을 |item|["launch_type"]으로 설정한다.
7. |accept:ordered map|을 새 [=ordered map=]으로 둔다.
8. |item|["accept"]의 각 |mime_type_string:string| → |extensions|에 대해 [=map/for each=]
   1. |extensions|가 [=list=]가 아니면, [=iteration/continue=]한다.
   2. |extensions|가 [=list/empty=]이면, [=iteration/continue=]한다.
   3. |extensions|가 [=string=]이 아닌 항목을 [=list/contains=]하면, [=iteration/continue=]한다.
   4. |extensions|가 문자 `.`로 시작하지 않는 문자열을 [=list/contains=]하면, [=iteration/continue=]한다.
   5. |extensions|가 16자보다 긴 문자열을 [=list/contains=]하면, [=iteration/continue=]한다.
   6. |mime_type_parsed:mime type|을 |mime_type_string|에 대해 [=parse a mime type=] 단계를 실행한 결과로 둔다.
   7. |mime_type_parsed:mime type|이 failure이면, [=iteration/continue=]한다.
   8. |mime_type_parsed/type|이 [[IANA-MEDIA-TYPES]]의 top-level type으로 나열되어 있지 않으면, [=iteration/continue=]한다.
   9. |accept|[|mime_type_string|]을 |extensions|로 설정한다.
9. |accept:ordered map|이 비어 있으면, failure를 반환한다.
10. |file_handler:ordered map|을 |ordered map| «[ "action" → |url|, "name" → |item|["name"], "launch_type" → |launch_type|, "accept" → |accept| ]»로 둔다.
11. |item|["icons"], |file_handler|, |manifest URL| 및 "icons"를 전달하여 Process image resources한다.
12. |file_handler|를 반환한다.

File handler launch 실행

execute a file handler launch 단계는 다음 알고리즘으로 주어진다. 이 알고리즘은 [=list=] |files:list|와 [=processing a manifest=]의 결과를 보유하는 [=ordered map=] |manifest:ordered_map|을 취한다.

1. |file_handlers:list|를 |manifest|["file_handlers"]로 둔다.
2. |file_handlers:list|가 null이면, 반환한다.
3. |launches:ordered map|을 [=ordered map=]으로 둔다.
4. |files|의 각 |filename:string|에 대해 [=list/for each=]
   1. |file_handlers:list|의 각 |file_handler:ordered_map|에 대해 [=list/for each=]:
      1. |file_handler|["accept"]의 각 |mime_type_string:string| → |extensions:list|에 대해 [=map/for each=]
         1. |extensions|의 각 |extension:string|에 대해 [=list/for each=]:
            1. |filename|이 |extension|으로 끝나지 않으면, [=iteration/continue=]한다.
            2. |launches|[|file_handler|]가 [=map/exists=]하면, |filename|을 |launches|[|file_handler|]에 [=list/append=]한다.
            3. 그렇지 않으면, |launches|[|file_handler|]를 단일 요소 |filename|을 가진 [=list=]로 설정한다.
            4. |files|의 다음 요소로 [=iteration/Continue=]한다.
5. |launches|의 각 |file_handler| → |files:list|에 대해 [=map/for each=]
   1. |file_handler|["launch_type"]이 "multiple-clients"와 같으면
      1. |files|의 각 |file|에 대해 [=list/for each=]
         1. |params:LaunchParams|를 {{LaunchParams/targetURL}}가 |file_handler|["action"]으로 설정되고 {{LaunchParams/files}}가 |file|에 대응하는 단일 요소 {{FileSystemHandle}}를 가진 {{FrozenArray}}로 설정된 새 {{LaunchParams}}로 둔다.
         2. |manifest| 및 |params|를 전달하여 [=Launch a web application with handling=]한다.
   2. 그렇지 않으면,
      1. |params:LaunchParams|를 {{LaunchParams/targetURL}}가 |file_handler|["action"]으로 설정되고 {{LaunchParams/files}}가 |files|로 명명된 파일 경로에 대응하는 {{FileSystemHandle}}들의 {{FrozenArray}}로 설정된 새 {{LaunchParams}}로 둔다.
      2. |manifest| 및 |params|를 전달하여 [=Launch a web application with handling=]한다.

File handlers 등록

사용자 에이전트는 다음과 일관되게 host 운영체제에 register file handlers해야 한다(SHOULD):

• 앱은 native file browser 및 주어진 파일이나 file type을 처리할 수 있는 앱 목록을 표시하는 기타 surfaces와 같은 적절한 OS surfaces에 노출된다.
• 앱은 연결된 file types에 대한 시스템 기본 handler가 될 후보이다.

사용자 에이전트는 기능을 보존하고 남용을 방지하기 위해 [=file extensions=]의 전체 집합을 잘라낼 수 있다(MAY). 사용자 에이전트는 특정 filetypes와의 연결을 방지할 수 있다(MAY).

개인정보 고려 사항: 기본 file handler.

운영체제의 기능에 따라, [=file handler=]는 사용자의 명시적 인지 없이 주어진 [=file type=]의 기본 handler가 되어 해당 file type의 실행을 자동으로 처리할 수 있다. 가능한 오용을 방지하기 위해, [=user agents=]는 [=execute a file handler launch=] 과정을 시작하기 전에 명시적 사용자 동의를 요구할 수 있다(MAY). 동의를 요청하는 경우, 사용자 에이전트는 사용자가 그 결정을 영구적으로 지정할 수 있도록 허용해야 하며(SHOULD), 그렇게 지정된 경우 웹 애플리케이션의 OS file handling entity 등록을 제거해야 한다(SHOULD).

개인정보 고려 사항: 이름과 아이콘.

각 file handler의 이름과 아이콘은 개인정보 및 보안에 민감할 수 있다. 사용자가 이를 보고 확인하는 지정된 방법이 없기 때문이다. 이로 인해, [=user agents=]는 대체 문자열과 아이콘을 선호하거나 OS 기본값으로 fallback하기 위해 이를 무시하도록 선택할 수 있다(MAY).

`scope_extensions` 멤버 처리

[=ordered map=] |json:ordered map|, [=ordered map=] |manifest:ordered map| 및 [=URL=] |manifest_id:URL|가 주어졌을 때 process the `scope_extensions` member하려면:

1. |processedScopeExtensions:list|를 새 [=list=]로 둔다.
2. |manifest|["scope_extensions"]를 |processedScopeExtensions|로 설정한다.
3. |json|["scope_extensions"]가 [=map/exist=]하지 않거나 [=list=]가 아니면, 반환한다.
4. |json|["scope_extensions"]의 각 |entry:ordered map|에 대해 [=list/For each=]:
   1. |entry|["type"] 또는 |entry|["origin"]이 [=map/exist=]하지 않으면, [=iteration/continue=]한다.
   2. |entry|["type"]이 "origin"이 아니면, [=iteration/continue=]한다.
   3. |entry|["origin"]이 [=string=]이 아니면, [=iteration/continue=]한다.
   4. [=URL=] |origin_url:URL|을 |entry|["origin"]을 [=URL Parser|파싱=]한 결과로 둔다.
   5. |origin_url|이 [=URL/scheme=] "https"를 가진 유효한 |URL|이면, |entry|["origin"]을 |origin_url|의 [=URL/origin=]으로 설정한다.
   6. 그렇지 않으면 [=iteration/continue=]한다.
   7. [=ordered map=] |entry:ordered map| 및 [=URL=] |manifest_id:URL|가 주어졌을 때 [=validate scope extensions=]의 알고리즘을 사용하여 |entry|를 검증한다.
   8. 이전 단계가 error를 반환했으면, [=iteration/continue=]한다.
   9. 그렇지 않으면, |entry|["scope"]를 반환된 [=URL=]로 설정한다.
   10. |entry|를 |processedScopeExtensions|에 [=list/Append=]한다.

Scope extensions 검증

[=ordered map=] |extension:ordered map| 및 [=URL=] |manifest_id:URL|가 주어졌을 때 validate scope extensions하려면:

1. [=URL=] |origin_url:URL|을 |extension|["origin"]의 [=URL/origin=]의 [=URL=]로 둔다.
2. [=URL=] |download_url:URL|을 |origin_url|을 base [=URL=]로 사용하여 "/.well-known/web-app-origin-association"을 [=URL Parser|파싱=]한 결과로 둔다.
3. [=ordered map=] |json:ordered map|을 |download_url|가 주어진 [=fetch=]의 결과로 둔다.
4. [=fetch=]가 실패했으면, error를 반환한다.
5. |json|[|manifest_id|]가 [=map/exist=]하지 않거나 [=ordered map=]이 아니면, error를 반환한다.
6. [=string=] |scope:string|를 "/"로 둔다.
7. |json|[|manifest_id|]["scope"]가 [=map/exists=]하고 [=string=]이면, |scope|를 |json|[|manifest_id|]["scope"]로 설정한다.
8. [=URL=] |resolved_scope:URL|을 |extension|["origin"]을 base [=URL=]로 하여 |scope|를 [=URL Parser|파싱=]한 결과로 둔다.
9. |resolved_scope|를 반환한다.

Scope extensions 적용

사용자 에이전트는 어떤 시나리오에서는 apply extended scope를 적용하고 다른 시나리오에서는 [=manifest/scope=]를 적용하도록 선택할 수 있다(MAY).

[=application context=]의 [=navigable/active document=]의 [=URL=]이 [=manifest/within scope=]가 아니지만 [=within extended scope=]이면, 사용자 에이전트는 사용자가 [=URL=] 또는 적어도 그 [=origin=]을, secure connection을 통해 제공되는지 여부를 포함하여 확인할 수 있게 하는 UI를 제공해야 한다(SHOULD). 이 UI는 [=URL=]이 [=application context=]의 [=Document/processed manifest=]의 [=manifest/within scope=]가 아닐 때 사용되는 UI와 달라야 하며(SHOULD), 사용자가 여전히 애플리케이션의 의도된 콘텐츠를 탐색하고 있음을 분명히 하면서도 다른 [=origin=]으로 탐색하는 것의 개인정보 및 보안 영향을 계속 알 수 있게 해야 한다.

migrate_from 멤버

[=manifest/migrate_from=] 멤버는 migration 대상이 되는 이전 웹 애플리케이션을 식별하는 [=strings=] 또는 [=ordered maps=]의 [=list=]이다.

entry가 [=string=]이면, 이전 애플리케이션의 [=manifest/id=]로 취급된다.

entry가 [=ordered map=]이면, 다음 멤버들을 가질 수 있다:

• id: 이전 애플리케이션의 [=manifest/id=]를 나타내는 [=string=].
• install_url: 이전 애플리케이션의 manifest로 연결되는 페이지의 URL을 나타내는 [=string=]. 사용자 에이전트는 이전 애플리케이션의 일부인 다른 모든 URL이 새 애플리케이션으로 redirect하더라도 업데이트를 적용하기 위해 이 필드를 사용하여 이전 애플리케이션의 manifest를 fetch할 수 있다.
• behavior: `"suggest"` 또는 `"force"` 중 하나일 수 있는 [=string=]. 이는 migration에 대해 사용자에게 알리기 위해 사용자 에이전트가 표시하는 UI가 얼마나 강제적인지에 영향을 줄 수 있는 hint이다.

migrate_to 멤버

[=manifest/migrate_to=] 멤버는 새 애플리케이션으로의 migration을 능동적으로 알리는 선택적 [=ordered map=]이다. 다음 멤버들을 가진다:

• id: 새 애플리케이션의 [=manifest/id=]를 나타내는 [=string=].
• install_url: 새 애플리케이션의 manifest로 연결되는 페이지의 URL을 나타내는 [=string=]. 이 페이지의 manifest는 migration이 처리되기 위해 이 애플리케이션을 다시 가리키는 [=manifest/migrate_from=] 필드를 포함해야 한다.

Origin migration 검증

[=URL=] |old_manifest_id:URL| 및 [=URL=] |new_manifest_id:URL|가 주어졌을 때 validate origin migration하려면:

1. |old_manifest_id|의 [=URL/origin=]과 |new_manifest_id|의 [=URL/origin=]이 [=same site=]가 아니면, error를 반환한다.
2. |old_manifest_id|의 [=URL/origin=]이 |new_manifest_id|의 [=URL/origin=]과 [=same origin=]이면, success를 반환한다.
3. [=URL=] |origin_url:URL|을 |old_manifest_id|의 [=URL/origin=]으로 둔다.
4. [=URL=] |download_url:URL|을 |origin_url|을 base [=URL=]로 사용하여 "/.well-known/web-app-origin-association"을 [=URL Parser|파싱=]한 결과로 둔다.
5. [=ordered map=] |json:ordered map|을 |download_url|가 주어진 [=fetch=]의 결과로 둔다.
6. [=fetch=]가 실패했으면, error를 반환한다.
7. |json|[|new_manifest_id|]가 [=map/exist=]하지 않거나 [=ordered map=]이 아니면, error를 반환한다.
8. |json|[|new_manifest_id|]["allow_migration"]이 `true`가 아니면, error를 반환한다.
9. success를 반환한다.

`migrate_from` 멤버 처리

[=ordered map=] |json:ordered map|, [=ordered map=] |manifest:ordered map| 및 [=URL=] |manifest URL:URL|가 주어졌을 때 process the `migrate_from` member하려면:

1. |json|["id"]가 [=map/exist=]하지 않거나 [=string=]이 아니면, 반환한다.
2. |json|["id"]가 빈 문자열이면, 반환한다.
3. |base_origin:origin|을 |manifest|["start_url"]의 [=URL/origin=]으로 둔다.
4. |id_url:URL|을 |base_origin|을 기본 URL로 하여 |json|["id"]를 [=URL Parser|parsing=]한 결과로 둔다.
5. |id_url|이 failure이면, 반환한다.
6. |id_url|이 |manifest|["start_url"]와 [=same origin=]이 아니면, 반환한다.
7. |processed_migrate_from:list|를 새 [=list=]로 둔다.
8. |manifest|["migrate_from"]을 |processed_migrate_from|로 설정한다.
9. |json|["migrate_from"]이 [=map/exist=]하지 않거나 [=list=]가 아니면, 반환한다.
10. |json|["migrate_from"]의 각 |entry|에 대해 [=list/For each=]:
    1. |processed_entry:ordered map|을 새 [=ordered map=]로 둔다.
    2. |entry|가 [=string=]인 경우:
       1. |id:URL|을 |manifest URL|을 기본 URL로 하여 |entry|를 [=URL Parser|parsing=]한 결과로 둔다.
       2. |id|가 failure이면, [=iteration/continue=]한다.
       3. |processed_entry|의 [=migrate_from_item/id=]를 |id|로 설정한다.
    3. 그렇지 않고 |entry|가 [=ordered map=]인 경우:
       1. |entry|의 [=migrate_from_item/id=]가 [=map/exist=]하지 않거나 [=string=]이 아니면, [=iteration/continue=]한다.
       2. |id:URL|을 |manifest URL|을 기본 URL로 하여 |entry|의 [=migrate_from_item/id=]를 [=URL Parser|parsing=]한 결과로 둔다.
       3. |id|가 failure이면, [=iteration/continue=]한다.
       4. |processed_entry|의 [=migrate_from_item/id=]를 |id|로 설정한다.
       5. |entry|의 [=migrate_from_item/install_url=]이 [=map/exists=]하고 [=string=]인 경우:
          1. |install_url:URL|을 |manifest URL|을 기본 URL로 하여 |entry|의 [=migrate_from_item/install_url=]을 [=URL Parser|parsing=]한 결과로 둔다.
          2. |install_url|이 failure가 아니면, |processed_entry|의 [=migrate_from_item/install_url=]을 |install_url|로 설정한다.
       6. |entry|의 [=migrate_from_item/behavior=]가 [=map/exists=]하고 [=string=]인 경우:
          1. |entry|의 [=migrate_from_item/behavior=]가 "suggest" 또는 "force"이면, |processed_entry|의 [=migrate_from_item/behavior=]를 |entry|의 [=migrate_from_item/behavior=]로 설정한다.
    4. 그렇지 않으면, [=iteration/continue=]한다.
    5. [=validate origin migration=]의 알고리즘을 사용하여 [=URL=] |processed_entry|의 [=migrate_from_item/id=]와 [=URL=] |id_url|이 주어졌을 때 |processed_entry|의 [=migrate_from_item/id=]를 검증한다.
    6. 이전 단계가 오류를 반환했다면, [=iteration/continue=]한다.
    7. |processed_entry|를 |processed_migrate_from|에 [=list/Append=]한다.

`migrate_to` 멤버 처리

[=ordered map=] |json:ordered map|, [=ordered map=] |manifest:ordered map| 및 [=URL=] |manifest URL:URL|가 주어졌을 때 process the `migrate_to` member하려면:

1. |json|["migrate_to"]가 [=map/exist=]하지 않거나 [=ordered map=]가 아니면, 반환한다.
2. |entry:ordered map|을 |json|["migrate_to"]로 둔다.
3. |entry|의 [=migrate_to_item/id=]가 [=map/exist=]하지 않거나 [=string=]이 아니면, 반환한다.
4. |id:URL|을 |manifest URL|을 기본 URL로 하여 |entry|의 [=migrate_to_item/id=]를 [=URL Parser|parsing=]한 결과로 둔다.
5. |id|가 failure이면, 반환한다.
6. |processed_migrate_to:ordered map|을 새 [=ordered map=]로 둔다.
7. |processed_migrate_to|의 [=migrate_to_item/id=]를 |id|로 설정한다.
8. |entry|의 [=migrate_to_item/install_url=]이 [=map/exists=]하고 [=string=]인 경우:
   1. |install_url:URL|을 |manifest URL|을 기본 URL로 하여 |entry|의 [=migrate_to_item/install_url=]을 [=URL Parser|parsing=]한 결과로 둔다.
   2. |install_url|이 failure가 아니면, |processed_migrate_to|의 [=migrate_to_item/install_url=]을 |install_url|로 설정한다.
9. |manifest|["migrate_to"]를 |processed_migrate_to|로 설정한다.

개인정보 및 보안 고려 사항

악의적인 행위자가 조용히 애플리케이션을 takeover하는 것(예: 단순한 계산기 앱이 자신을 은행 앱처럼 보이도록 업데이트하는 것)을 방지하기 위해, [=validate origin migration=] 알고리즘은 양방향 handshake를 강제한다. 새 애플리케이션 origin과 이전 애플리케이션 origin 모두 [=web-app-origin-association=] 파일을 통해 migration에 명시적으로 동의해야 한다.

또한 migration은 검증되지 않은 제3자에게 ownership을 이전하는 것이 아니라 조직의 통제 내에서 이루어지는 정당한 rebranding 및 architecture 변경에 사용되도록 보장하기 위해 [=same site=]로 제한된다.

사용자 에이전트는 특히 app name 및 icons와 같은 보안에 민감한 필드의 업데이트가 포함된 경우, migration flow의 일부로 명시적 사용자 확인 dialog를 포함하는 것을 고려해야 한다.

`platform` 멤버

platform 멤버는 이 [=external application resource=]가 연결된 [=platform=]을 나타낸다. platform은 software distribution ecosystem 또는 가능하게는 operating system을 나타낸다. 이 명세는 platform 멤버의 특정 값을 정의하지 않는다.

`url` 멤버

[=external application resource's=] url 멤버는 애플리케이션을 찾을 수 있는 URL이다.

process the `url` member of an application하려면:

1. application URL이 missing이면, null을 반환한다.
2. 그렇지 않으면, application URL을 [=URL Parser|parse=]하고, 결과가 failure가 아니면 결과를 반환한다. 그렇지 않으면 null을 반환한다.

`id` 멤버

[=external application resource's=] id 멤버는 platform에서 애플리케이션을 나타내는 데 사용되는 id를 나타낸다.

`min_version` 멤버

[=external application resource's=] min_version 멤버는 이 웹 앱과 관련 있다고 간주되는 애플리케이션의 minimum version을 나타낸다. 이 version은 platform-specific syntax 및 semantics를 가진 string이다.

`fingerprints` 멤버

[=external application resource=]의 fingerprints 멤버는 [=fingerprints=]의 [=list=]를 나타낸다.

fingerprint는 애플리케이션을 검증하는 데 사용되는 암호학적 fingerprint들의 집합을 나타낸다. fingerprint는 다음 두 멤버를 가진다: type 및 value. 이들은 각각 문자열이지만, 그 구문과 의미는 플랫폼에 의해 정의된다.

Installation 과정

steps to install the web application은 다음 알고리즘으로 주어진다:

1. manifest를 installable document의 manifest로 둔다.
2. 사용자의 운영체제에 웹 애플리케이션을 등록하려는 지정되지 않은 일련의 작업을 수행한다(예: 웹 애플리케이션을 실행하는 shortcuts 생성, system uninstall menu에 애플리케이션 등록 등). 설치가 실패하면 (예를 들어 OS가 사용자 에이전트에게 기기의 home screen에 아이콘을 추가할 권한을 거부하는 등 어떤 이유로든 가능하다) 이 단계들을 abort한다.
3. 설치가 발생한 [=top-level browsing context=]의 [=relevant global object=]에 `"appinstalled"`라는 이름의 fire an event를 수행하도록 application life-cycle task source에 Queue a task한다.

BeforeInstallPromptEvent 인터페이스

          [Exposed=Window]
          interface BeforeInstallPromptEvent : Event {
            constructor(DOMString type, optional EventInit eventInitDict = {});
            Promise<PromptResponseObject> prompt();
          };

          dictionary PromptResponseObject {
            AppBannerPromptOutcome userChoice;
          };

          enum AppBannerPromptOutcome {
            "accepted",
            "dismissed"
          };
        

{{BeforeInstallPromptEvent}}는 사이트가 site-triggered install prompt를 표시할 수 있도록 허용될 때, 또는 사용자 에이전트가 automated install prompt를 표시하기 전에 dispatch된다. 이는 사이트가 automated install prompt를 cancel할 수 있게 하고, 또한 site-triggered install prompt를 수동으로 표시할 수 있게 한다.

PromptResponseObject는 {{BeforeInstallPromptEvent/prompt()}}를 호출한 결과를 포함한다. 이는 사용자가 선택한 outcome을 나타내는 하나의 멤버 userChoice를 포함한다.

{{BeforeInstallPromptEvent}}의 인스턴스는 다음 internal slots를 가진다:

[[\didPrompt]]

초기에 `false`인 boolean. 이 이벤트가 최종 사용자에게 present an install prompt하는 데 사용되었는지를 나타낸다.

[[\userResponsePromise]]

presenting an install prompt의 outcome을 나타내는 promise.

              window.addEventListener("beforeinstallprompt", event => {
                // Suppress automatic prompting.
                event.preventDefault();

                // Show the (disabled-by-default) install button. This button
                // resolves the installButtonClicked promise when clicked.
                installButton.disabled = false;

                // Wait for the user to click the button.
                installButton.addEventListener("click", async e => {
                  // The prompt() method can only be used once.
                  installButton.disabled = true;

                  // Show the prompt.
                  const userChoice = await event.prompt();
                  console.info(`user choice was: ${userChoice}`);
                });
              });
            

`Window` object에 대한 확장

          partial interface Window {
            attribute EventHandler onappinstalled;
            attribute EventHandler onbeforeinstallprompt;
          };