외부 URL 열기

openURL 함수는 지정한 URL을 기기의 기본 브라우저나 연결된 앱에서 열 수 있게 해주는 유틸리티예요. 이 함수는 React Native의 Linking.openURL을 내부적으로 사용해요.

시그니처

function openURL(url: string): Promise<any>;

파라미터

• url · 필수 · string

  열고자 하는 외부 웹 주소 또는 딥링크 경로예요.

반환 값

• Promise<any>

  URL이 성공적으로 열렸을 때 resolve되는 Promise를 반환해요.

예제

외부 웹사이트 열기

tsx[React]

import { openURL } from '@apps-in-toss/web-framework';

function Page() {
  const handlePress = () => {
    openURL('https://google.com');
  };

  return (
    <button onClick={handlePress}>
      구글 웹사이트 열기
    </button>
  );
}

React Native

import { openURL } from '@granite-js/react-native';
import { Button } from 'react-native';

function Page() {
  const handlePress = () => {
    openURL('https://google.com');
  };

  return <Button title="구글 웹사이트 열기" onPress={handlePress} />;
}

딥링크 열기

tsx[React]

import { openURL } from '@apps-in-toss/web-framework';

openURL('intoss://{appName}');

React Native

import { openURL } from '@granite-js/react-native';

openURL('intoss://{appName}');

참고사항

• 외부 URL을 열 수 없는 경우(잘못된 스킴, 네트워크 차단 등)에는 Promise가 reject될 수 있어요.
• WebView 환경에서는 브라우저 탭이 새로 열리며, 기본 앱에서는 외부 앱 또는 브라우저로 전환돼요.