File: nsIEnterprisePolicies.idl

package info (click to toggle)
firefox-esr 128.13.0esr-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 4,230,012 kB
  • sloc: cpp: 7,103,971; javascript: 6,088,450; ansic: 3,653,980; python: 1,212,330; xml: 594,604; asm: 420,652; java: 182,969; sh: 71,124; makefile: 20,747; perl: 13,449; objc: 12,399; yacc: 4,583; cs: 3,846; pascal: 2,973; lex: 1,720; ruby: 1,194; exp: 762; php: 436; lisp: 258; awk: 247; sql: 66; sed: 54; csh: 10
file content (80 lines) | stat: -rw-r--r-- 2,538 bytes parent folder | download | duplicates (9)
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
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"
#include "nsIURI.idl"

[scriptable, uuid(6a568972-cc91-4bf5-963e-3768f3319b8a)]
interface nsIEnterprisePolicies : nsISupports
{
  const short UNINITIALIZED = -1;
  const short INACTIVE      = 0;
  const short ACTIVE        = 1;
  const short FAILED        = 2;

  readonly attribute short status;
  // We only consider a build to be enterprise when certain conditions are
  // met. This value is set between profile-do-change and addons-startup,
  // so it should be usable from most places.
  readonly attribute boolean isEnterprise;

  boolean isAllowed(in ACString feature);

  /**
   * Get the active policies that have been successfully parsed.
   *
   * @returns A JS object that contains the policies names and
   *          their corresponding parameters.
   */
  jsval getActivePolicies();

  /**
   * Get the contents of the support menu (if applicable)
   *
   * @returns A JS object that contains the url and label or null.
   */
  jsval getSupportMenu();

  /**
   * Get the policy for a given extensionID (if available)
   *
   * @returns A JS object that contains the storage or null if unavailable.
   */
  jsval getExtensionPolicy(in ACString extensionID);

  /**
   * Retrieves the ExtensionSettings policy for the given extensionID.
   *
   * If there is no policy for the extension, it returns the global policy.
   *
   * If there is no global policy, it returns null.
   *
   * @returns A JS object that settings or null if unavailable.
   */
  jsval getExtensionSettings(in ACString extensionID);

  /**
   * Uses the allowlist, blocklist and settings to determine if an addon
   * may be installed.
   *
   * @returns A boolean - true of the addon may be installed.
   */
  boolean mayInstallAddon(in jsval addon);

  /**
   * Uses install_sources to determine if an addon can be installed
   * from the given URI.
   *
   * @returns A boolean - true of the addon may be installed.
   */
  boolean allowedInstallSource(in nsIURI uri);
  /**
   * Uses ExemptDomainFileTypePairsFromFileTypeDownloadWarnings to determine
   * if a given file extension is exempted from executable behavior and
   * warnings based on the URL.
   *
   * @returns A boolean - true if the extension should be exempt.
   */
  boolean isExemptExecutableExtension(in ACString url, in ACString extension);
};