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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
{
"$schema": "https://json-schema.org/draft/2019-09/schema",
"additionalProperties": false,
"type": "object",
"properties": {
"description": {
"type": "string"
},
"owner": {
"type": "string",
"description": "The owner of the feature."
},
"applications": {
"description": "The applications that can enroll in experiments for this feature. Defaults to firefox-desktop if not present.",
"type": "array",
"items": {
"type": "string",
"enum": [
"firefox-desktop",
"firefox-desktop-background-task"
]
},
"minItems": 1
},
"hasExposure": {
"type": "boolean",
"description": "If the feature sends an exposure event."
},
"exposureDescription": {
"type": "string",
"description": "A description of the implementation details of the exposure event, if one is sent."
},
"isEarlyStartup": {
"type": "boolean",
"description": "If the feature values should be cached in prefs for fast early startup."
},
"schema": {
"type": "object",
"description": "For features with large number of variables we instead point to a JSONSchema file instead of specifying them in the variables field",
"properties": {
"uri": {
"type": "string",
"description": "A resource:// URI that can be loaded at runtime from within Firefox.",
"format": "uri"
},
"path": {
"type": "string",
"description": "The path to the schema file relative to the repository root"
}
},
"required": [
"uri",
"path"
]
},
"variables": {
"additionalProperties": false,
"type": "object",
"patternProperties": {
"[a-zA-Z0-9_]+": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"json",
"boolean",
"int",
"string"
]
},
"fallbackPref": {
"type": "string",
"description": "A pref that provides the default value for a feature when none is present"
},
"setPref": {
"type": "string",
"description": "A pref that should be set to the value of this variable when enrolling in experiments."
},
"enum": {
"description": "Validate feature value using a list of possible options (for string only values)."
},
"description": {
"type": "string",
"description": "Explain how this value is being used"
}
},
"required": [
"type",
"description"
],
"additionalProperties": false,
"dependentSchemas": {
"fallbackPref": {
"description": "setPref is mutually exclusive with fallbackPref",
"properties": {
"setPref": {
"const": null
}
}
},
"setPref": {
"description": "fallbackPref is mutually exclusive with setPref",
"properties": {
"fallbackPref": {
"const": null
}
}
}
}
}
}
}
},
"required": [
"description",
"hasExposure"
],
"if": {
"properties": {
"hasExposure": {
"const": true
}
}
},
"then": {
"required": [
"exposureDescription"
]
}
}
|
