본문으로 건너뛰기

getTossAppVersion

현재 실행 중인 토스 앱의 버전을 동기적으로 반환합니다. '5.206.0'과 같은 semver 형태의 문자열로 반환되며, 버전별 기능 분기나 로그 기록에 활용합니다.

시그니처​

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

declare function getTossAppVersion(): string;

파라미터​

없음.

반환값​

  • string — 토스 앱 버전 문자열. 예: '5.206.0' (major.minor.patch 형식).
버전 비교는 isMinVersionSupported를 사용하세요

문자열 버전을 직접 비교(>, <)하면 lexicographic 비교로 잘못된 결과가 나올 수 있습니다. 버전 분기가 필요하다면 isMinVersionSupported를 사용하세요.

권한​

권한이 필요하지 않습니다 — getTossAppVersion은 별도의 PermissionName에 바인딩되지 않습니다. 권한이 필요한 다른 네임스페이스의 일반적인 처리 흐름은 Guides — 권한 처리 패턴을 참고하세요.

예제​

최소 예제​

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

const version = getTossAppVersion();
console.log('토스 앱 버전:', version); // 예: '5.206.0'

실전 예제 — 버전 정보를 에러 리포트에 포함하기​

import { getTossAppVersion, getPlatformOS } from '@apps-in-toss/web-framework';
import { useEffect } from 'react';

function App() {
  useEffect(() => {
    const appVersion = getTossAppVersion();
    const platform = getPlatformOS();

    window.addEventListener('unhandledrejection', (event) => {
      console.error('[error]', {
        appVersion,
        platform,
        reason: event.reason,
      });
    });
  }, []);

  return <main>{/* 앱 콘텐츠 */}</main>;
}

직접 실행해 보기​

sdk-example의 Environment 페이지에서 getTossAppVersion 카드를 실행해 결과를 확인할 수 있습니다.

sdk-example에서 실행해 보기

관련 API​

관련 가이드​

외부 참조​

  • @apps-in-toss/web-framework — 상위 SDK 패키지. 실제 export는 내부적으로 @apps-in-toss/web-bridge에서 가져옵니다.
  • 표준 Web API 대응: 없음 — 호스트 앱(토스) 버전은 표준 Web API로 접근할 수 없는 정보입니다.