Blame view

node_modules/caniuse-lite/README.md 4.71 KB
6a9ffbcc   liuqimichale   地图点击事件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
  # caniuse-lite
  
  > A smaller version of caniuse-db, with only the essentials!
  
  ## Why?
  
  The full data behind [Can I use][1] is incredibly useful for any front end
  developer, and on the website all of the details from the database are displayed
  to the user. However in automated tools, [many of these fields go unused][2];
  it's not a problem for server side consumption but client side, the less
  JavaScript that we send to the end user the better.
  
  caniuse-lite then, is a smaller dataset that keeps essential parts of the data
  in a compact format. It does this in multiple ways, such as converting `null`
  array entries into empty strings, representing support data as an integer rather
  than a string, and using base62 references instead of longer human-readable
  keys.
  
  This packed data is then reassembled (via functions exposed by this module) into
  a larger format which is mostly compatible with caniuse-db, and so it can be
  used as an almost drop-in replacement for caniuse-db for contexts where size on
  disk is important; for example, usage in web browsers. The API differences are
  very small and are detailed in the section below.
  
  
  ## API
  
  ```js
  import * as lite from 'caniuse-lite';
  ```
  
  ### `lite.agents`
  
  caniuse-db provides a full `data.json` file which contains all of the features
  data. Instead of this large file, caniuse-lite provides this data subset
  instead, which has the `browser`, `prefix`, `prefix_exceptions`, `usage_global`
  and `versions` keys from the original.
  
  In addition, the subset contains the `release_date` key with release dates (as timestamps) for each version:
  ```json
  {
    "release_date": {
      "6": 998870400,
      "7": 1161129600,
      "8": 1237420800,
      "9": 1300060800,
      "10": 1346716800,
      "11": 1381968000,
      "5.5": 962323200
    }
  }
  ```
  
  ### `lite.feature(js)`
  
  The `feature` method takes a file from `data/features` and converts it into
  something that more closely represents the `caniuse-db` format. Note that only
  the `title`, `stats` and `status` keys are kept from the original data.
  
  ### `lite.features`
  
  The `features` index is provided as a way to query all of the features that
  are listed in the `caniuse-db` dataset. Note that you will need to use the
  `feature` method on values from this index to get a human-readable format.
  
  ### `lite.region(js)`
  
  The `region` method takes a file from `data/regions` and converts it into
  something that more closely represents the `caniuse-db` format. Note that *only*
  the usage data is exposed here (the `data` key in the original files).
  
  
  ## Contributors
  
  Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):
  
  <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
  <!-- prettier-ignore -->
  | [<img src="https://avatars.githubusercontent.com/u/1282980?v=3" width="100px;"/><br /><sub><b>Ben Briggs</b></sub>](http://beneb.info)<br />[💻](https://github.com/ben-eb/caniuse-lite/commits?author=ben-eb "Code") [📖](https://github.com/ben-eb/caniuse-lite/commits?author=ben-eb "Documentation") [👀](#review-ben-eb "Reviewed Pull Requests") [⚠️](https://github.com/ben-eb/caniuse-lite/commits?author=ben-eb "Tests") | [<img src="https://avatars.githubusercontent.com/u/1737375?v=3" width="100px;"/><br /><sub><b>Andy Jansson</b></sub>](https://github.com/andyjansson)<br />[💻](https://github.com/ben-eb/caniuse-lite/commits?author=andyjansson "Code") | [<img src="https://avatars1.githubusercontent.com/u/19343?v=4" width="100px;"/><br /><sub><b>Andrey Sitnik</b></sub>](http://twitter.com/sitnikcode)<br />[💻](https://github.com/ben-eb/caniuse-lite/commits?author=ai "Code") | [<img src="https://avatars2.githubusercontent.com/u/947326?v=4" width="100px;"/><br /><sub><b>Igor Deryabin</b></sub>](http://rodweb.ru)<br />[💻](https://github.com/ben-eb/caniuse-lite/commits?author=rodweb "Code") |
  | :---: | :---: | :---: | :---: |
  <!-- ALL-CONTRIBUTORS-LIST:END -->
  
  This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind welcome!
  
  <img src="https://opensource.nyc3.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_icon_blue.svg" alt="Digital Ocean logo" width="40" align="left">
  
  Big thanks to [DigitalOcean](https://www.digitalocean.com/?utm_source=opensource&utm_campaign=caniuse-lite) for supporting this project by providing their great infrastructure for us.
  
  ## License
  
  The data in this repo is available for use under a CC BY 4.0 license
  (http://creativecommons.org/licenses/by/4.0/). For attribution just mention
  somewhere that the source is caniuse.com. If you have any questions about using
  the data for your project please contact me here: http://a.deveria.com/contact
  
  [1]: http://caniuse.com/
  [2]: https://github.com/Fyrd/caniuse/issues/1827