File Explorer

1'use strict'2 3const { Blob, File } = require('node:buffer')4const { kState } = require('./symbols')5const { webidl } = require('./webidl')6 7// TODO(@KhafraDev): remove8class FileLike {9  constructor (blobLike, fileName, options = {}) {10    // TODO: argument idl type check11 12    // The File constructor is invoked with two or three parameters, depending13    // on whether the optional dictionary parameter is used. When the File()14    // constructor is invoked, user agents must run the following steps:15 16    // 1. Let bytes be the result of processing blob parts given fileBits and17    // options.18 19    // 2. Let n be the fileName argument to the constructor.20    const n = fileName21 22    // 3. Process FilePropertyBag dictionary argument by running the following23    // substeps:24 25    //    1. If the type member is provided and is not the empty string, let t26    //    be set to the type dictionary member. If t contains any characters27    //    outside the range U+0020 to U+007E, then set t to the empty string28    //    and return from these substeps.29    //    TODO30    const t = options.type31 32    //    2. Convert every character in t to ASCII lowercase.33    //    TODO34 35    //    3. If the lastModified member is provided, let d be set to the36    //    lastModified dictionary member. If it is not provided, set d to the37    //    current date and time represented as the number of milliseconds since38    //    the Unix Epoch (which is the equivalent of Date.now() [ECMA-262]).39    const d = options.lastModified ?? Date.now()40 41    // 4. Return a new File object F such that:42    // F refers to the bytes byte sequence.43    // F.size is set to the number of total bytes in bytes.44    // F.name is set to n.45    // F.type is set to t.46    // F.lastModified is set to d.47 48    this[kState] = {49      blobLike,50      name: n,51      type: t,52      lastModified: d53    }54  }55 56  stream (...args) {57    webidl.brandCheck(this, FileLike)58 59    return this[kState].blobLike.stream(...args)60  }61 62  arrayBuffer (...args) {63    webidl.brandCheck(this, FileLike)64 65    return this[kState].blobLike.arrayBuffer(...args)66  }67 68  slice (...args) {69    webidl.brandCheck(this, FileLike)70 71    return this[kState].blobLike.slice(...args)72  }73 74  text (...args) {75    webidl.brandCheck(this, FileLike)76 77    return this[kState].blobLike.text(...args)78  }79 80  get size () {81    webidl.brandCheck(this, FileLike)82 83    return this[kState].blobLike.size84  }85 86  get type () {87    webidl.brandCheck(this, FileLike)88 89    return this[kState].blobLike.type90  }91 92  get name () {93    webidl.brandCheck(this, FileLike)94 95    return this[kState].name96  }97 98  get lastModified () {99    webidl.brandCheck(this, FileLike)100 101    return this[kState].lastModified102  }103 104  get [Symbol.toStringTag] () {105    return 'File'106  }107}108 109webidl.converters.Blob = webidl.interfaceConverter(Blob)110 111// If this function is moved to ./util.js, some tools (such as112// rollup) will warn about circular dependencies. See:113// https://github.com/nodejs/undici/issues/1629114function isFileLike (object) {115  return (116    (object instanceof File) ||117    (118      object &&119      (typeof object.stream === 'function' ||120      typeof object.arrayBuffer === 'function') &&121      object[Symbol.toStringTag] === 'File'122    )123  )124}125 126module.exports = { FileLike, isFileLike }127