Package Exports

apple-model-names

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (apple-model-names) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Apple Model Names

A tiny helper library to convert Apple hardware strings ("iPhone6,2") into human-readable model names ("iPhone 5s").

Supports the following device hardware strings:

📱: iPhone, iPad (all types), iPod touch
💻: MacBook, MacBook Pro, MacBook Air
🖥: Mac mini, Mac Pro, iMac
📺 Apple TV, ⌚ Apple Watch

Usage

First, install the library:

npm install --save apple-model-names

Then, import and use:

import getModelName from 'apple-model-names';

getModelName('iPhone6,2'); // 'iPhone 5s'
getModelName('iPhone6,2', { split: true }); // ['iPhone', '5s']

// Examples with no matching result
getModelName('iPhone99,9'); // 'iPhone 99,9'
getModelName('iCrazy1,1'); // 'Other'

Options

An options hash can be passed in as a second parameter to customize the return data. Here are the available options:

Option	Default Value	Description
`split`	`false`	Return an array with the device and model split up (i.e. `['iPhone', '5s']`). This is useful when needing more fine-grained control, such as styling each piece of text differently in your UI.
`noMatchString`	`'Other'`	The string to return for unrecognized device names.

Translation Sources

The translations are human-curated from various Apple support links and wiki pages. Here are the resources we use:

https://www.theiphonewiki.com/wiki/Models (iPhone, iPad, iPod, Apple Watch, Apple TV)
https://support.apple.com/en-us/HT201608 (MacBook)
https://support.apple.com/en-us/HT201862 (MacBook Air)
https://support.apple.com/en-us/HT201300 (MacBook Pro)
https://en.wikipedia.org/wiki/Mac_Mini (Mac mini)
https://support.apple.com/en-us/HT202888 (Mac Pro)
https://support.apple.com/en-us/HT201634 (iMac)

Missing a new model? Found a bug?

We welcome contributions! Feel free to open an issue (or a PR!) if you notice any missing models (new releases, etc.), or spot a bug. Thanks!

License

Licensed under the MIT License: https://opensource.org/licenses/MIT