diff options
author | Rogan Creswick <creswick@gmail.com> | 2013-01-02 15:31:43 -0800 |
---|---|---|
committer | Rogan Creswick <creswick@gmail.com> | 2013-01-02 15:31:43 -0800 |
commit | 91c8d16838b39c7726f6c0a0fb333f5ba38d2494 (patch) | |
tree | 136df17525e5e62f3ddc5b7a6dc71ffd31e2aa42 /tools/addon-sdk-1.12/lib/sdk/net/url.js | |
parent | f7b228c479bac8828e521a2826d7f57f150da877 (diff) |
updated addon-sdk to 1.12
Diffstat (limited to 'tools/addon-sdk-1.12/lib/sdk/net/url.js')
-rw-r--r-- | tools/addon-sdk-1.12/lib/sdk/net/url.js | 108 |
1 files changed, 108 insertions, 0 deletions
diff --git a/tools/addon-sdk-1.12/lib/sdk/net/url.js b/tools/addon-sdk-1.12/lib/sdk/net/url.js new file mode 100644 index 0000000..5992e0d --- /dev/null +++ b/tools/addon-sdk-1.12/lib/sdk/net/url.js @@ -0,0 +1,108 @@ +/* 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/. */ + +const { Cu, components } = require("chrome"); +const { defer } = require("../core/promise"); +const { merge } = require("../util/object"); + +const { NetUtil } = Cu.import("resource://gre/modules/NetUtil.jsm", {}); + +/** + * Open a channel synchronously for the URI given, with an optional charset, and + * returns a resolved promise if succeed; rejected promise otherwise. + */ +function readSync(uri, charset) { + let { promise, resolve, reject } = defer(); + + try { + resolve(readURISync(uri, charset)); + } + catch (e) { + reject("Failed to read: '" + uri + "' (Error Code: " + e.result + ")"); + } + + return promise; +} + +/** + * Open a channel synchronously for the URI given, with an optional charset, and + * returns a promise. + */ +function readAsync(uri, charset) { + let channel = NetUtil.newChannel(uri, charset, null); + + let { promise, resolve, reject } = defer(); + + NetUtil.asyncFetch(channel, function (stream, result) { + if (components.isSuccessCode(result)) { + let count = stream.available(); + let data = NetUtil.readInputStreamToString(stream, count, { charset : charset }); + + resolve(data); + } else { + reject("Failed to read: '" + uri + "' (Error Code: " + result + ")"); + } + }); + + return promise; +} + +/** + * Reads a URI and returns a promise. If the `sync` option is set to `true`, the + * promise will be resolved synchronously. + * + * @param uri {string} The URI to read + * @param [options] {object} This parameter can have any or all of the following + * fields: `sync`, `charset`. By default the `charset` is set to 'UTF-8'. + * + * @returns {promise} The promise that will be resolved with the content of the + * URL given. + * + * @example + * let promise = readURI('resource://gre/modules/NetUtil.jsm', { + * sync: true, + * charset: 'US-ASCII' + }); + */ +function readURI(uri, options) { + options = merge({ + charset: "UTF-8", + sync: false + }, options); + + return options.sync + ? readSync(uri, options.charset) + : readAsync(uri, options.charset); +} + +exports.readURI = readURI; + +/** + * Reads a URI synchronously. + * This function is intentionally undocumented to favorites the `readURI` usage. + * + * @param uri {string} The URI to read + * @param [charset] {string} The character set to use when read the content of + * the `uri` given. By default is set to 'UTF-8'. + * + * @returns {string} The content of the URI given. + * + * @example + * let data = readURISync('resource://gre/modules/NetUtil.jsm'); + */ +function readURISync(uri, charset) { + charset = typeof charset === "string" ? charset : "UTF-8"; + + let channel = NetUtil.newChannel(uri, charset, null); + let stream = channel.open(); + + let count = stream.available(); + let data = NetUtil.readInputStreamToString(stream, count, { charset : charset }); + + stream.close(); + + return data; +} + +exports.readURISync = readURISync; |