Web Share API | Minstudio

Web Share API: 네이티브 공유 경험 제공

Web Share API는 브라우저에서 모바일 및 데스크톱 운영 체제의 기본(Native) 공유 다이얼로그를 호출할 수 있게 해주는 웹 표준입니다. 카카오톡, 페이스북 등의 소셜 미디어 공유 버튼을 각각 별도로 구현할 필요 없이, 사용자의 기기에 설치된 앱을 통해 직관적이고 일관된 공유 경험을 제공합니다. (단, HTTPS 환경 및 사용자의 명시적 클릭 같은 상호작용이 필수적입니다.)

1. 네이티브 공유 데이터 흐름

버튼 클릭부터 운영체제의 공유 팝업이 뜨기까지의 흐름도입니다.

2. 주요 메서드 (Methods)

Web Share API가 제공하는 핵심 메서드입니다.

메서드	설명
`navigator.share(data)`	제공된 데이터 객체(title, text, url 등)를 네이티브 공유 다이얼로그로 전달합니다. `Promise`를 반환합니다.
`navigator.canShare(data)`	주어진 데이터가 현재 브라우저/기기 환경에서 공유 가능한지 여부를 `boolean`으로 반환합니다. (공유 시도 전에 검사 용도로 사용)

3. ShareData 객체 속성

navigator.share()에 전달하는 데이터 객체의 구성 요소입니다. 최소 하나 이상의 속성이 포함되어야 합니다.

속성명	타입	설명
`title`	`string`	공유할 문서나 콘텐츠의 제목입니다. (OS에 따라 무시될 수도 있습니다.)
`text`	`string`	공유할 핵심 텍스트나 설명 메시지입니다.
`url`	`string`	공유할 링크(URL) 주소입니다. 보통 페이지 전체를 공유할 때 사용합니다.
`files`	`File[]`	공유할 파일들의 배열입니다. 이미지 파일이나 문서 등을 공유할 때 사용됩니다.