summaryrefslogtreecommitdiffhomepage
path: root/docs/jsapi/uci.js.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/jsapi/uci.js.html')
-rw-r--r--docs/jsapi/uci.js.html994
1 files changed, 994 insertions, 0 deletions
diff --git a/docs/jsapi/uci.js.html b/docs/jsapi/uci.js.html
new file mode 100644
index 000000000..d61010f0e
--- /dev/null
+++ b/docs/jsapi/uci.js.html
@@ -0,0 +1,994 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="utf-8">
+ <title>JSDoc: Source: uci.js</title>
+
+ <script src="scripts/prettify/prettify.js"> </script>
+ <script src="scripts/prettify/lang-css.js"> </script>
+ <!--[if lt IE 9]>
+ <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+ <![endif]-->
+ <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+ <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+
+<body>
+
+<div id="main">
+
+ <h1 class="page-title">Source: uci.js</h1>
+
+
+
+
+
+
+ <section>
+ <article>
+ <pre class="prettyprint source linenums"><code>'use strict';
+'require rpc';
+
+/**
+ * @class uci
+ * @memberof LuCI
+ * @hideconstructor
+ * @classdesc
+ *
+ * The `LuCI.uci` class utilizes {@link LuCI.rpc} to declare low level
+ * remote UCI `ubus` procedures and implements a local caching and data
+ * manipulation layer on top to allow for synchroneous operations on
+ * UCI configuration data.
+ */
+return L.Class.extend(/** @lends LuCI.uci.prototype */ {
+ __init__: function() {
+ this.state = {
+ newidx: 0,
+ values: { },
+ creates: { },
+ changes: { },
+ deletes: { },
+ reorder: { }
+ };
+
+ this.loaded = {};
+ },
+
+ callLoad: rpc.declare({
+ object: 'uci',
+ method: 'get',
+ params: [ 'config' ],
+ expect: { values: { } }
+ }),
+
+
+ callOrder: rpc.declare({
+ object: 'uci',
+ method: 'order',
+ params: [ 'config', 'sections' ]
+ }),
+
+ callAdd: rpc.declare({
+ object: 'uci',
+ method: 'add',
+ params: [ 'config', 'type', 'name', 'values' ],
+ expect: { section: '' }
+ }),
+
+ callSet: rpc.declare({
+ object: 'uci',
+ method: 'set',
+ params: [ 'config', 'section', 'values' ]
+ }),
+
+ callDelete: rpc.declare({
+ object: 'uci',
+ method: 'delete',
+ params: [ 'config', 'section', 'options' ]
+ }),
+
+ callApply: rpc.declare({
+ object: 'uci',
+ method: 'apply',
+ params: [ 'timeout', 'rollback' ]
+ }),
+
+ callConfirm: rpc.declare({
+ object: 'uci',
+ method: 'confirm'
+ }),
+
+
+ /**
+ * Generates a new, unique section ID for the given configuration.
+ *
+ * Note that the generated ID is temporary, it will get replaced by an
+ * identifier in the form `cfgXXXXXX` once the configuration is saved
+ * by the remote `ubus` UCI api.
+ *
+ * @param {string} config
+ * The configuration to generate the new section ID for.
+ *
+ * @returns {string}
+ * A newly generated, unique section ID in the form `newXXXXXX`
+ * where `X` denotes a hexadecimal digit.
+ */
+ createSID: function(conf) {
+ var v = this.state.values,
+ n = this.state.creates,
+ sid;
+
+ do {
+ sid = "new%06x".format(Math.random() * 0xFFFFFF);
+ } while ((n[conf] &amp;&amp; n[conf][sid]) || (v[conf] &amp;&amp; v[conf][sid]));
+
+ return sid;
+ },
+
+ /**
+ * Resolves a given section ID in extended notation to the internal
+ * section ID value.
+ *
+ * @param {string} config
+ * The configuration to resolve the section ID for.
+ *
+ * @param {string} sid
+ * The section ID to resolve. If the ID is in the form `@typename[#]`,
+ * it will get resolved to an internal anonymous ID in the forms
+ * `cfgXXXXXX`/`newXXXXXX` or to the name of a section in case it points
+ * to a named section. When the given ID is not in extended notation,
+ * it will be returned as-is.
+ *
+ * @returns {string|null}
+ * Returns the resolved section ID or the original given ID if it was
+ * not in extended notation. Returns `null` when an extended ID could
+ * not be resolved to existing section ID.
+ */
+ resolveSID: function(conf, sid) {
+ if (typeof(sid) != 'string')
+ return sid;
+
+ var m = /^@([a-zA-Z0-9_-]+)\[(-?[0-9]+)\]$/.exec(sid);
+
+ if (m) {
+ var type = m[1],
+ pos = +m[2],
+ sections = this.sections(conf, type),
+ section = sections[pos >= 0 ? pos : sections.length + pos];
+
+ return section ? section['.name'] : null;
+ }
+
+ return sid;
+ },
+
+ /* private */
+ reorderSections: function() {
+ var v = this.state.values,
+ n = this.state.creates,
+ r = this.state.reorder,
+ tasks = [];
+
+ if (Object.keys(r).length === 0)
+ return Promise.resolve();
+
+ /*
+ gather all created and existing sections, sort them according
+ to their index value and issue an uci order call
+ */
+ for (var c in r) {
+ var o = [ ];
+
+ if (n[c])
+ for (var s in n[c])
+ o.push(n[c][s]);
+
+ for (var s in v[c])
+ o.push(v[c][s]);
+
+ if (o.length > 0) {
+ o.sort(function(a, b) {
+ return (a['.index'] - b['.index']);
+ });
+
+ var sids = [ ];
+
+ for (var i = 0; i &lt; o.length; i++)
+ sids.push(o[i]['.name']);
+
+ tasks.push(this.callOrder(c, sids));
+ }
+ }
+
+ this.state.reorder = { };
+ return Promise.all(tasks);
+ },
+
+ /* private */
+ loadPackage: function(packageName) {
+ if (this.loaded[packageName] == null)
+ return (this.loaded[packageName] = this.callLoad(packageName));
+
+ return Promise.resolve(this.loaded[packageName]);
+ },
+
+ /**
+ * Loads the given UCI configurations from the remote `ubus` api.
+ *
+ * Loaded configurations are cached and only loaded once. Subsequent
+ * load operations of the same configurations will return the cached
+ * data.
+ *
+ * To force reloading a configuration, it has to be unloaded with
+ * {@link LuCI.uci#unload uci.unload()} first.
+ *
+ * @param {string|string[]} config
+ * The name of the configuration or an array of configuration
+ * names to load.
+ *
+ * @returns {Promise&lt;string[]>}
+ * Returns a promise resolving to the names of the configurations
+ * that have been successfully loaded.
+ */
+ load: function(packages) {
+ var self = this,
+ pkgs = [ ],
+ tasks = [];
+
+ if (!Array.isArray(packages))
+ packages = [ packages ];
+
+ for (var i = 0; i &lt; packages.length; i++)
+ if (!self.state.values[packages[i]]) {
+ pkgs.push(packages[i]);
+ tasks.push(self.loadPackage(packages[i]));
+ }
+
+ return Promise.all(tasks).then(function(responses) {
+ for (var i = 0; i &lt; responses.length; i++)
+ self.state.values[pkgs[i]] = responses[i];
+
+ if (responses.length)
+ document.dispatchEvent(new CustomEvent('uci-loaded'));
+
+ return pkgs;
+ });
+ },
+
+ /**
+ * Unloads the given UCI configurations from the local cache.
+ *
+ * @param {string|string[]} config
+ * The name of the configuration or an array of configuration
+ * names to unload.
+ */
+ unload: function(packages) {
+ if (!Array.isArray(packages))
+ packages = [ packages ];
+
+ for (var i = 0; i &lt; packages.length; i++) {
+ delete this.state.values[packages[i]];
+ delete this.state.creates[packages[i]];
+ delete this.state.changes[packages[i]];
+ delete this.state.deletes[packages[i]];
+
+ delete this.loaded[packages[i]];
+ }
+ },
+
+ /**
+ * Adds a new section of the given type to the given configuration,
+ * optionally named according to the given name.
+ *
+ * @param {string} config
+ * The name of the configuration to add the section to.
+ *
+ * @param {string} type
+ * The type of the section to add.
+ *
+ * @param {string} [name]
+ * The name of the section to add. If the name is omitted, an anonymous
+ * section will be added instead.
+ *
+ * @returns {string}
+ * Returns the section ID of the newly added section which is equivalent
+ * to the given name for non-anonymous sections.
+ */
+ add: function(conf, type, name) {
+ var n = this.state.creates,
+ sid = name || this.createSID(conf);
+
+ if (!n[conf])
+ n[conf] = { };
+
+ n[conf][sid] = {
+ '.type': type,
+ '.name': sid,
+ '.create': name,
+ '.anonymous': !name,
+ '.index': 1000 + this.state.newidx++
+ };
+
+ return sid;
+ },
+
+ /**
+ * Removes the section with the given ID from the given configuration.
+ *
+ * @param {string} config
+ * The name of the configuration to remove the section from.
+ *
+ * @param {string} sid
+ * The ID of the section to remove.
+ */
+ remove: function(conf, sid) {
+ var n = this.state.creates,
+ c = this.state.changes,
+ d = this.state.deletes;
+
+ /* requested deletion of a just created section */
+ if (n[conf] &amp;&amp; n[conf][sid]) {
+ delete n[conf][sid];
+ }
+ else {
+ if (c[conf])
+ delete c[conf][sid];
+
+ if (!d[conf])
+ d[conf] = { };
+
+ d[conf][sid] = true;
+ }
+ },
+
+ /**
+ * A section object represents the options and their corresponding values
+ * enclosed within a configuration section, as well as some additional
+ * meta data such as sort indexes and internal ID.
+ *
+ * Any internal metadata fields are prefixed with a dot which is isn't
+ * an allowed character for normal option names.
+ *
+ * @typedef {Object&lt;string, boolean|number|string|string[]>} SectionObject
+ * @memberof LuCI.uci
+ *
+ * @property {boolean} .anonymous
+ * The `.anonymous` property specifies whether the configuration is
+ * anonymous (`true`) or named (`false`).
+ *
+ * @property {number} .index
+ * The `.index` property specifes the sort order of the section.
+ *
+ * @property {string} .name
+ * The `.name` property holds the name of the section object. It may be
+ * either an anonymous ID in the form `cfgXXXXXX` or `newXXXXXX` with `X`
+ * being a hexadecimal digit or a string holding the name of the section.
+ *
+ * @property {string} .type
+ * The `.type` property contains the type of the corresponding uci
+ * section.
+ *
+ * @property {string|string[]} *
+ * A section object may contain an arbitrary number of further properties
+ * representing the uci option enclosed in the section.
+ *
+ * All option property names will be in the form `[A-Za-z0-9_]+` and
+ * either contain a string value or an array of strings, in case the
+ * underlying option is an UCI list.
+ */
+
+ /**
+ * The sections callback is invoked for each section found within
+ * the given configuration and receives the section object and its
+ * associated name as arguments.
+ *
+ * @callback LuCI.uci~sectionsFn
+ *
+ * @param {LuCI.uci.SectionObject} section
+ * The section object.
+ *
+ * @param {string} sid
+ * The name or ID of the section.
+ */
+
+ /**
+ * Enumerates the sections of the given configuration, optionally
+ * filtered by type.
+ *
+ * @param {string} config
+ * The name of the configuration to enumerate the sections for.
+ *
+ * @param {string} [type]
+ * Enumerate only sections of the given type. If omitted, enumerate
+ * all sections.
+ *
+ * @param {LuCI.uci~sectionsFn} [cb]
+ * An optional callback to invoke for each enumerated section.
+ *
+ * @returns {Array&lt;LuCI.uci.SectionObject>}
+ * Returns a sorted array of the section objects within the given
+ * configuration, filtered by type of a type has been specified.
+ */
+ sections: function(conf, type, cb) {
+ var sa = [ ],
+ v = this.state.values[conf],
+ n = this.state.creates[conf],
+ c = this.state.changes[conf],
+ d = this.state.deletes[conf];
+
+ if (!v)
+ return sa;
+
+ for (var s in v)
+ if (!d || d[s] !== true)
+ if (!type || v[s]['.type'] == type)
+ sa.push(Object.assign({ }, v[s], c ? c[s] : undefined));
+
+ if (n)
+ for (var s in n)
+ if (!type || n[s]['.type'] == type)
+ sa.push(Object.assign({ }, n[s]));
+
+ sa.sort(function(a, b) {
+ return a['.index'] - b['.index'];
+ });
+
+ for (var i = 0; i &lt; sa.length; i++)
+ sa[i]['.index'] = i;
+
+ if (typeof(cb) == 'function')
+ for (var i = 0; i &lt; sa.length; i++)
+ cb.call(this, sa[i], sa[i]['.name']);
+
+ return sa;
+ },
+
+ /**
+ * Gets the value of the given option within the specified section
+ * of the given configuration or the entire section object if the
+ * option name is omitted.
+ *
+ * @param {string} config
+ * The name of the configuration to read the value from.
+ *
+ * @param {string} sid
+ * The name or ID of the section to read.
+ *
+ * @param {string} [option]
+ * The option name to read the value from. If the option name is
+ * omitted or `null`, the entire section is returned instead.
+ *
+ * @returns {null|string|string[]|LuCI.uci.SectionObject}
+ * - Returns a string containing the option value in case of a
+ * plain UCI option.
+ * - Returns an array of strings containing the option values in
+ * case of `option` pointing to an UCI list.
+ * - Returns a {@link LuCI.uci.SectionObject section object} if
+ * the `option` argument has been omitted or is `null`.
+ * - Returns `null` if the config, section or option has not been
+ * found or if the corresponding configuration is not loaded.
+ */
+ get: function(conf, sid, opt) {
+ var v = this.state.values,
+ n = this.state.creates,
+ c = this.state.changes,
+ d = this.state.deletes;
+
+ sid = this.resolveSID(conf, sid);
+
+ if (sid == null)
+ return null;
+
+ /* requested option in a just created section */
+ if (n[conf] &amp;&amp; n[conf][sid]) {
+ if (!n[conf])
+ return undefined;
+
+ if (opt == null)
+ return n[conf][sid];
+
+ return n[conf][sid][opt];
+ }
+
+ /* requested an option value */
+ if (opt != null) {
+ /* check whether option was deleted */
+ if (d[conf] &amp;&amp; d[conf][sid]) {
+ if (d[conf][sid] === true)
+ return undefined;
+
+ for (var i = 0; i &lt; d[conf][sid].length; i++)
+ if (d[conf][sid][i] == opt)
+ return undefined;
+ }
+
+ /* check whether option was changed */
+ if (c[conf] &amp;&amp; c[conf][sid] &amp;&amp; c[conf][sid][opt] != null)
+ return c[conf][sid][opt];
+
+ /* return base value */
+ if (v[conf] &amp;&amp; v[conf][sid])
+ return v[conf][sid][opt];
+
+ return undefined;
+ }
+
+ /* requested an entire section */
+ if (v[conf])
+ return v[conf][sid];
+
+ return undefined;
+ },
+
+ /**
+ * Sets the value of the given option within the specified section
+ * of the given configuration.
+ *
+ * If either config, section or option is null, or if `option` begins
+ * with a dot, the function will do nothing.
+ *
+ * @param {string} config
+ * The name of the configuration to set the option value in.
+ *
+ * @param {string} sid
+ * The name or ID of the section to set the option value in.
+ *
+ * @param {string} option
+ * The option name to set the value for.
+ *
+ * @param {null|string|string[]} value
+ * The option value to set. If the value is `null` or an empty string,
+ * the option will be removed, otherwise it will be set or overwritten
+ * with the given value.
+ */
+ set: function(conf, sid, opt, val) {
+ var v = this.state.values,
+ n = this.state.creates,
+ c = this.state.changes,
+ d = this.state.deletes;
+
+ sid = this.resolveSID(conf, sid);
+
+ if (sid == null || opt == null || opt.charAt(0) == '.')
+ return;
+
+ if (n[conf] &amp;&amp; n[conf][sid]) {
+ if (val != null)
+ n[conf][sid][opt] = val;
+ else
+ delete n[conf][sid][opt];
+ }
+ else if (val != null &amp;&amp; val !== '') {
+ /* do not set within deleted section */
+ if (d[conf] &amp;&amp; d[conf][sid] === true)
+ return;
+
+ /* only set in existing sections */
+ if (!v[conf] || !v[conf][sid])
+ return;
+
+ if (!c[conf])
+ c[conf] = {};
+
+ if (!c[conf][sid])
+ c[conf][sid] = {};
+
+ /* undelete option */
+ if (d[conf] &amp;&amp; d[conf][sid])
+ d[conf][sid] = d[conf][sid].filter(function(o) { return o !== opt });
+
+ c[conf][sid][opt] = val;
+ }
+ else {
+ /* only delete in existing sections */
+ if (!(v[conf] &amp;&amp; v[conf][sid] &amp;&amp; v[conf][sid].hasOwnProperty(opt)) &amp;&amp;
+ !(c[conf] &amp;&amp; c[conf][sid] &amp;&amp; c[conf][sid].hasOwnProperty(opt)))
+ return;
+
+ if (!d[conf])
+ d[conf] = { };
+
+ if (!d[conf][sid])
+ d[conf][sid] = [ ];
+
+ if (d[conf][sid] !== true)
+ d[conf][sid].push(opt);
+ }
+ },
+
+ /**
+ * Remove the given option within the specified section of the given
+ * configuration.
+ *
+ * This function is a convenience wrapper around
+ * `uci.set(config, section, option, null)`.
+ *
+ * @param {string} config
+ * The name of the configuration to remove the option from.
+ *
+ * @param {string} sid
+ * The name or ID of the section to remove the option from.
+ *
+ * @param {string} option
+ * The name of the option to remove.
+ */
+ unset: function(conf, sid, opt) {
+ return this.set(conf, sid, opt, null);
+ },
+
+ /**
+ * Gets the value of the given option or the entire section object of
+ * the first found section of the specified type or the first found
+ * section of the entire configuration if no type is specfied.
+ *
+ * @param {string} config
+ * The name of the configuration to read the value from.
+ *
+ * @param {string} [type]
+ * The type of the first section to find. If it is `null`, the first
+ * section of the entire config is read, otherwise the first section
+ * matching the given type.
+ *
+ * @param {string} [option]
+ * The option name to read the value from. If the option name is
+ * omitted or `null`, the entire section is returned instead.
+ *
+ * @returns {null|string|string[]|LuCI.uci.SectionObject}
+ * - Returns a string containing the option value in case of a
+ * plain UCI option.
+ * - Returns an array of strings containing the option values in
+ * case of `option` pointing to an UCI list.
+ * - Returns a {@link LuCI.uci.SectionObject section object} if
+ * the `option` argument has been omitted or is `null`.
+ * - Returns `null` if the config, section or option has not been
+ * found or if the corresponding configuration is not loaded.
+ */
+ get_first: function(conf, type, opt) {
+ var sid = null;
+
+ this.sections(conf, type, function(s) {
+ if (sid == null)
+ sid = s['.name'];
+ });
+
+ return this.get(conf, sid, opt);
+ },
+
+ /**
+ * Sets the value of the given option within the first found section
+ * of the given configuration matching the specified type or within
+ * the first section of the entire config when no type has is specified.
+ *
+ * If either config, type or option is null, or if `option` begins
+ * with a dot, the function will do nothing.
+ *
+ * @param {string} config
+ * The name of the configuration to set the option value in.
+ *
+ * @param {string} [type]
+ * The type of the first section to find. If it is `null`, the first
+ * section of the entire config is written to, otherwise the first
+ * section matching the given type is used.
+ *
+ * @param {string} option
+ * The option name to set the value for.
+ *
+ * @param {null|string|string[]} value
+ * The option value to set. If the value is `null` or an empty string,
+ * the option will be removed, otherwise it will be set or overwritten
+ * with the given value.
+ */
+ set_first: function(conf, type, opt, val) {
+ var sid = null;
+
+ this.sections(conf, type, function(s) {
+ if (sid == null)
+ sid = s['.name'];
+ });
+
+ return this.set(conf, sid, opt, val);
+ },
+
+ /**
+ * Removes the given option within the first found section of the given
+ * configuration matching the specified type or within the first section
+ * of the entire config when no type has is specified.
+ *
+ * This function is a convenience wrapper around
+ * `uci.set_first(config, type, option, null)`.
+ *
+ * @param {string} config
+ * The name of the configuration to set the option value in.
+ *
+ * @param {string} [type]
+ * The type of the first section to find. If it is `null`, the first
+ * section of the entire config is written to, otherwise the first
+ * section matching the given type is used.
+ *
+ * @param {string} option
+ * The option name to set the value for.
+ */
+ unset_first: function(conf, type, opt) {
+ return this.set_first(conf, type, opt, null);
+ },
+
+ /**
+ * Move the first specified section within the given configuration
+ * before or after the second specified section.
+ *
+ * @param {string} config
+ * The configuration to move the section within.
+ *
+ * @param {string} sid1
+ * The ID of the section to move within the configuration.
+ *
+ * @param {string} [sid2]
+ * The ID of the target section for the move operation. If the
+ * `after` argument is `false` or not specified, the section named by
+ * `sid1` will be moved before this target section, if the `after`
+ * argument is `true`, the `sid1` section will be moved after this
+ * section.
+ *
+ * When the `sid2` argument is `null`, the section specified by `sid1`
+ * is moved to the end of the configuration.
+ *
+ * @param {boolean} [after=false]
+ * When `true`, the section `sid1` is moved after the section `sid2`,
+ * when `false`, the section `sid1` is moved before `sid2`.
+ *
+ * If `sid2` is null, then this parameter has no effect and the section
+ * `sid1` is moved to the end of the configuration instead.
+ *
+ * @returns {boolean}
+ * Returns `true` when the section was successfully moved, or `false`
+ * when either the section specified by `sid1` or by `sid2` is not found.
+ */
+ move: function(conf, sid1, sid2, after) {
+ var sa = this.sections(conf),
+ s1 = null, s2 = null;
+
+ sid1 = this.resolveSID(conf, sid1);
+ sid2 = this.resolveSID(conf, sid2);
+
+ for (var i = 0; i &lt; sa.length; i++) {
+ if (sa[i]['.name'] != sid1)
+ continue;
+
+ s1 = sa[i];
+ sa.splice(i, 1);
+ break;
+ }
+
+ if (s1 == null)
+ return false;
+
+ if (sid2 == null) {
+ sa.push(s1);
+ }
+ else {
+ for (var i = 0; i &lt; sa.length; i++) {
+ if (sa[i]['.name'] != sid2)
+ continue;
+
+ s2 = sa[i];
+ sa.splice(i + !!after, 0, s1);
+ break;
+ }
+
+ if (s2 == null)
+ return false;
+ }
+
+ for (var i = 0; i &lt; sa.length; i++)
+ this.get(conf, sa[i]['.name'])['.index'] = i;
+
+ this.state.reorder[conf] = true;
+
+ return true;
+ },
+
+ /**
+ * Submits all local configuration changes to the remove `ubus` api,
+ * adds, removes and reorders remote sections as needed and reloads
+ * all loaded configurations to resynchronize the local state with
+ * the remote configuration values.
+ *
+ * @returns {string[]}
+ * Returns a promise resolving to an array of configuration names which
+ * have been reloaded by the save operation.
+ */
+ save: function() {
+ var v = this.state.values,
+ n = this.state.creates,
+ c = this.state.changes,
+ d = this.state.deletes,
+ r = this.state.reorder,
+ self = this,
+ snew = [ ],
+ pkgs = { },
+ tasks = [];
+
+ if (n)
+ for (var conf in n) {
+ for (var sid in n[conf]) {
+ var r = {
+ config: conf,
+ values: { }
+ };
+
+ for (var k in n[conf][sid]) {
+ if (k == '.type')
+ r.type = n[conf][sid][k];
+ else if (k == '.create')
+ r.name = n[conf][sid][k];
+ else if (k.charAt(0) != '.')
+ r.values[k] = n[conf][sid][k];
+ }
+
+ snew.push(n[conf][sid]);
+ tasks.push(self.callAdd(r.config, r.type, r.name, r.values));
+ }
+
+ pkgs[conf] = true;
+ }
+
+ if (c)
+ for (var conf in c) {
+ for (var sid in c[conf])
+ tasks.push(self.callSet(conf, sid, c[conf][sid]));
+
+ pkgs[conf] = true;
+ }
+
+ if (d)
+ for (var conf in d) {
+ for (var sid in d[conf]) {
+ var o = d[conf][sid];
+ tasks.push(self.callDelete(conf, sid, (o === true) ? null : o));
+ }
+
+ pkgs[conf] = true;
+ }
+
+ if (r)
+ for (var conf in r)
+ pkgs[conf] = true;
+
+ return Promise.all(tasks).then(function(responses) {
+ /*
+ array "snew" holds references to the created uci sections,
+ use it to assign the returned names of the new sections
+ */
+ for (var i = 0; i &lt; snew.length; i++)
+ snew[i]['.name'] = responses[i];
+
+ return self.reorderSections();
+ }).then(function() {
+ pkgs = Object.keys(pkgs);
+
+ self.unload(pkgs);
+
+ return self.load(pkgs);
+ });
+ },
+
+ /**
+ * Instructs the remote `ubus` UCI api to commit all saved changes with
+ * rollback protection and attempts to confirm the pending commit
+ * operation to cancel the rollback timer.
+ *
+ * @param {number} [timeout=10]
+ * Override the confirmation timeout after which a rollback is triggered.
+ *
+ * @returns {Promise&lt;number>}
+ * Returns a promise resolving/rejecting with the `ubus` RPC status code.
+ */
+ apply: function(timeout) {
+ var self = this,
+ date = new Date();
+
+ if (typeof(timeout) != 'number' || timeout &lt; 1)
+ timeout = 10;
+
+ return self.callApply(timeout, true).then(function(rv) {
+ if (rv != 0)
+ return Promise.reject(rv);
+
+ var try_deadline = date.getTime() + 1000 * timeout;
+ var try_confirm = function() {
+ return self.callConfirm().then(function(rv) {
+ if (rv != 0) {
+ if (date.getTime() &lt; try_deadline)
+ window.setTimeout(try_confirm, 250);
+ else
+ return Promise.reject(rv);
+ }
+
+ return rv;
+ });
+ };
+
+ window.setTimeout(try_confirm, 1000);
+ });
+ },
+
+ /**
+ * An UCI change record is a plain array containing the change operation
+ * name as first element, the affected section ID as second argument
+ * and an optional third and fourth argument whose meanings depend on
+ * the operation.
+ *
+ * @typedef {string[]} ChangeRecord
+ * @memberof LuCI.uci
+ *
+ * @property {string} 0
+ * The operation name - may be one of `add`, `set`, `remove`, `order`,
+ * `list-add`, `list-del` or `rename`.
+ *
+ * @property {string} 1
+ * The section ID targeted by the operation.
+ *
+ * @property {string} 2
+ * The meaning of the third element depends on the operation.
+ * - For `add` it is type of the section that has been added
+ * - For `set` it either is the option name if a fourth element exists,
+ * or the type of a named section which has been added when the change
+ * entry only contains three elements.
+ * - For `remove` it contains the name of the option that has been
+ * removed.
+ * - For `order` it specifies the new sort index of the section.
+ * - For `list-add` it contains the name of the list option a new value
+ * has been added to.
+ * - For `list-del` it contains the name of the list option a value has
+ * been removed from.
+ * - For `rename` it contains the name of the option that has been
+ * renamed if a fourth element exists, else it contains the new name
+ * a section has been renamed to if the change entry only contains
+ * three elements.
+ *
+ * @property {string} 4
+ * The meaning of the fourth element depends on the operation.
+ * - For `set` it is the value an option has been set to.
+ * - For `list-add` it is the new value that has been added to a
+ * list option.
+ * - For `rename` it is the new name of an option that has been
+ * renamed.
+ */
+
+ /**
+ * Fetches uncommitted UCI changes from the remote `ubus` RPC api.
+ *
+ * @method
+ * @returns {Promise&lt;Object&lt;string, Array&lt;LuCI.uci.ChangeRecord>>>}
+ * Returns a promise resolving to an object containing the configuration
+ * names as keys and arrays of related change records as values.
+ */
+ changes: rpc.declare({
+ object: 'uci',
+ method: 'changes',
+ expect: { changes: { } }
+ })
+});
+</code></pre>
+ </article>
+ </section>
+
+
+
+
+</div>
+
+<nav>
+ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="LuCI.html">LuCI</a></li><li><a href="LuCI.Class.html">Class</a></li><li><a href="LuCI.dom.html">dom</a></li><li><a href="LuCI.fs.html">fs</a></li><li><a href="LuCI.Headers.html">Headers</a></li><li><a href="LuCI.Network.html">Network</a></li><li><a href="LuCI.Network.Device.html">Device</a></li><li><a href="LuCI.Network.Hosts.html">Hosts</a></li><li><a href="LuCI.Network.Protocol.html">Protocol</a></li><li><a href="LuCI.Network.WifiDevice.html">WifiDevice</a></li><li><a href="LuCI.Network.WifiNetwork.html">WifiNetwork</a></li><li><a href="LuCI.Poll.html">Poll</a></li><li><a href="LuCI.Request.html">Request</a></li><li><a href="LuCI.Request.poll.html">poll</a></li><li><a href="LuCI.Response.html">Response</a></li><li><a href="LuCI.rpc.html">rpc</a></li><li><a href="LuCI.uci.html">uci</a></li><li><a href="LuCI.view.html">view</a></li><li><a href="LuCI.XHR.html">XHR</a></li></ul>
+</nav>
+
+<br class="clear">
+
+<footer>
+ Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.3</a> on Tue Nov 05 2019 09:33:05 GMT+0100 (Central European Standard Time)
+</footer>
+
+<script> prettyPrint(); </script>
+<script src="scripts/linenumber.js"> </script>
+</body>
+</html>