Skip to content

dents/apple-model-names

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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:

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

Copyright 2017 Google Inc.

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

About

Based on twitter-fabric's v1.1.7

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published