An open source design system that's fully customizable and agent ready
TypeScript
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
* @file isApplePlatform.ts
* @input Reads navigator.userAgentData.platform and navigator.platform
* @output Exports isApplePlatform
* @position Internal util; the single platform detection behind useHotkeys and Kbd
*
* Deliberately absent from utils/index.ts: packages/core/src/index.ts does
* `export * from './utils'`, so naming it there would publish it as API.
* Import it by path, as interactionModality is imported.
*/
/**
* Detects whether the current platform is macOS/iOS.
* Prefers the User-Agent Client Hints API when it names a platform (modern
* Chrome/Edge), falls back to navigator.platform (deprecated but universally
* supported) when it names none.
*/
export function isApplePlatform(): boolean {
if (typeof navigator === 'undefined') {
return false;
}
const uaData = 'userAgentData' in navigator ? navigator.userAgentData : null;
if (uaData && typeof uaData === 'object' && 'platform' in uaData) {
const uaPlatform = (uaData as {platform?: unknown}).platform;
const named = typeof uaPlatform === 'string' ? uaPlatform.trim() : '';
// A value that names nothing is no answer, not a negative one: builds that
// rewrite their client-hints identity ship '', and 'Unknown' is the spec's
// own sentinel for "cannot say". Both fall through rather than reading as
// "not Apple".
if (named !== '' && named.toLowerCase() !== 'unknown') {
return /mac/i.test(named);
}
}
return /Mac|iPhone|iPad|iPod/.test(navigator.platform ?? '');
}