OLD | NEW |
1 # Extension Features Files | 1 # Extension Features Files |
2 | 2 |
3 [TOC] | 3 [TOC] |
4 | 4 |
5 ## Summary | 5 ## Summary |
6 | 6 |
7 The Extension features files specify the different requirements for extension | 7 The Extension features files specify the different requirements for extension |
8 feature availability. | 8 feature availability. |
9 | 9 |
10 An **extension feature** can be any component of extension capabilities. Most | 10 An **extension feature** can be any component of extension capabilities. Most |
(...skipping 188 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
199 The only accepted value is the bool `false` (since true is the default). | 199 The only accepted value is the bool `false` (since true is the default). |
200 | 200 |
201 ### contexts | 201 ### contexts |
202 | 202 |
203 The `contexts` property specifies which JavaScript contexts can access the | 203 The `contexts` property specifies which JavaScript contexts can access the |
204 feature. All API features must specify at least one context, and only API | 204 feature. All API features must specify at least one context, and only API |
205 features can specify contexts. | 205 features can specify contexts. |
206 | 206 |
207 Accepted values are a list of strings from `blessed_extension`, | 207 Accepted values are a list of strings from `blessed_extension`, |
208 `blessed_web_page`, `content_script`, `extension_service_worker`, | 208 `blessed_web_page`, `content_script`, `extension_service_worker`, |
209 `web_page`, `webui`, and `unblessed_extension`. | 209 `lock_screen_extension`, `web_page`, `webui`, and `unblessed_extension`. |
| 210 |
| 211 The `lock_screen_extension` context is used instead of `blessed_extension` |
| 212 context for extensions on the Chrome OS lock screen. Other extensions related |
| 213 contexts (`blessed_web_page`, `content_script`, `extension_service_worker`, |
| 214 `unblessed_extension`) are not expected to be present on the lock screen. |
210 | 215 |
211 ### default\_parent | 216 ### default\_parent |
212 | 217 |
213 The `default_parent` property specifies a feature definition from a complex | 218 The `default_parent` property specifies a feature definition from a complex |
214 feature to be used as the parent for any children. See also Inheritance. | 219 feature to be used as the parent for any children. See also Inheritance. |
215 | 220 |
216 The only accepted value is the bool `true`. | 221 The only accepted value is the bool `true`. |
217 | 222 |
218 ### dependencies | 223 ### dependencies |
219 | 224 |
(...skipping 229 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
449 at runtime, this has the added benefit of allowing us to validate at compile | 454 at runtime, this has the added benefit of allowing us to validate at compile |
450 time rather than needing a unittest (or allowing incorrect features). | 455 time rather than needing a unittest (or allowing incorrect features). |
451 | 456 |
452 In theory, invalid features should result in a compilation failure; in practice, | 457 In theory, invalid features should result in a compilation failure; in practice, |
453 the compiler is probably missing some cases. | 458 the compiler is probably missing some cases. |
454 | 459 |
455 ## Still to come | 460 ## Still to come |
456 | 461 |
457 TODO(devlin): Add documentation for extension types. Probably also more on | 462 TODO(devlin): Add documentation for extension types. Probably also more on |
458 requirements for individual features. | 463 requirements for individual features. |
OLD | NEW |