summaryrefslogtreecommitdiffstats
path: root/toolkit/components/osfile/modules/osfile_native.jsm
blob: 28aed4396df77002c7e5d516884e188e8207efbc (plain)
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
/* 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/. */

/**
 * Native (xpcom) implementation of key OS.File functions
 */

"use strict";

var EXPORTED_SYMBOLS = ["read", "writeAtomic"];

var SharedAll = ChromeUtils.import(
  "resource://gre/modules/osfile/osfile_shared_allthreads.jsm",
  null
);

var SysAll = {};
if (SharedAll.Constants.Win) {
  ChromeUtils.import(
    "resource://gre/modules/osfile/osfile_win_allthreads.jsm",
    SysAll
  );
} else if (SharedAll.Constants.libc) {
  ChromeUtils.import(
    "resource://gre/modules/osfile/osfile_unix_allthreads.jsm",
    SysAll
  );
} else {
  throw new Error("I am neither under Windows nor under a Posix system");
}
var { XPCOMUtils } = ChromeUtils.import(
  "resource://gre/modules/XPCOMUtils.jsm"
);

/**
 * The native service holding the implementation of the functions.
 */
XPCOMUtils.defineLazyServiceGetter(
  this,
  "Internals",
  "@mozilla.org/toolkit/osfile/native-internals;1",
  "nsINativeOSFileInternalsService"
);

/**
 * Native implementation of OS.File.read
 *
 * This implementation does not handle option |compression|.
 */
var read = function(path, options = {}) {
  // Sanity check on types of options
  if ("encoding" in options && typeof options.encoding != "string") {
    return Promise.reject(new TypeError("Invalid type for option encoding"));
  }
  if ("compression" in options && typeof options.compression != "string") {
    return Promise.reject(new TypeError("Invalid type for option compression"));
  }
  if ("bytes" in options && typeof options.bytes != "number") {
    return Promise.reject(new TypeError("Invalid type for option bytes"));
  }

  return new Promise((resolve, reject) => {
    Internals.read(
      path,
      options,
      function onSuccess(success) {
        success.QueryInterface(Ci.nsINativeOSFileResult);
        if ("outExecutionDuration" in options) {
          options.outExecutionDuration =
            success.executionDurationMS + (options.outExecutionDuration || 0);
        }
        resolve(success.result);
      },
      function onError(operation, oserror) {
        reject(new SysAll.Error(operation, oserror, path));
      }
    );
  });
};

/**
 * Native implementation of OS.File.writeAtomic.
 * This should not be called when |buffer| is a view with some non-zero byte offset.
 * Does not handle option |compression|.
 */
var writeAtomic = function(path, buffer, options = {}) {
  // Sanity check on types of options - we check only the encoding, since
  // the others are checked inside Internals.writeAtomic.
  if ("encoding" in options && typeof options.encoding !== "string") {
    return Promise.reject(new TypeError("Invalid type for option encoding"));
  }

  if (typeof buffer == "string") {
    // Normalize buffer to a C buffer by encoding it
    let encoding = options.encoding || "utf-8";
    buffer = new TextEncoder(encoding).encode(buffer);
  }

  if (ArrayBuffer.isView(buffer)) {
    // We need to throw an error if it's a buffer with some byte offset.
    if ("byteOffset" in buffer && buffer.byteOffset > 0) {
      return Promise.reject(
        new Error("Invalid non-zero value of Typed Array byte offset")
      );
    }
    buffer = buffer.buffer;
  }

  return new Promise((resolve, reject) => {
    Internals.writeAtomic(
      path,
      buffer,
      options,
      function onSuccess(success) {
        success.QueryInterface(Ci.nsINativeOSFileResult);
        if ("outExecutionDuration" in options) {
          options.outExecutionDuration =
            success.executionDurationMS + (options.outExecutionDuration || 0);
        }
        resolve(success.result);
      },
      function onError(operation, oserror) {
        reject(new SysAll.Error(operation, oserror, path));
      }
    );
  });
};