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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
# Interface: ZipInputFile
A stream that can be used to create a file in a ZIP archive
## Hierarchy
* [ZipAttributes](zipattributes.md)
↳ **ZipInputFile**
## Implemented by
* [AsyncZipDeflate](../classes/asynczipdeflate.md)
* [ZipDeflate](../classes/zipdeflate.md)
* [ZipPassThrough](../classes/zippassthrough.md)
## Index
### Properties
* [attrs](zipinputfile.md#attrs)
* [comment](zipinputfile.md#comment)
* [compression](zipinputfile.md#compression)
* [crc](zipinputfile.md#crc)
* [extra](zipinputfile.md#extra)
* [filename](zipinputfile.md#filename)
* [flag](zipinputfile.md#flag)
* [mtime](zipinputfile.md#mtime)
* [ondata](zipinputfile.md#ondata)
* [os](zipinputfile.md#os)
* [size](zipinputfile.md#size)
* [terminate](zipinputfile.md#terminate)
## Properties
### attrs
• `Optional` **attrs**: number
*Inherited from [ZipAttributes](zipattributes.md).[attrs](zipattributes.md#attrs)*
The file's attributes. These are traditionally somewhat complicated
and platform-dependent, so using them is scarcely necessary. However,
here is a representation of what this is, bit by bit:
`TTTTugtrwxrwxrwx0000000000ADVSHR`
TTTT = file type (rarely useful)
u = setuid, g = setgid, t = sticky
rwx = user permissions, rwx = group permissions, rwx = other permissions
0000000000 = unused
A = archive, D = directory, V = volume label, S = system file, H = hidden, R = read-only
If you want to set the Unix permissions, for instance, just bit shift by 16, e.g. 0644 << 16
___
### comment
• `Optional` **comment**: string
*Inherited from [ZipAttributes](zipattributes.md).[comment](zipattributes.md#comment)*
The comment to attach to the file. This field is defined by PKZIP's APPNOTE.txt,
section 4.4.26. The comment must be at most 65,535 bytes long UTF-8 encoded. This
field is not read by consumer software.
___
### compression
• **compression**: number
The compression format for the data stream. This number is determined by
the spec in PKZIP's APPNOTE.txt, section 4.4.5. For example, 0 = no
compression, 8 = deflate, 14 = LZMA
___
### crc
• **crc**: number
A CRC of the original file contents. This attribute may be invalid after
the file is added to the ZIP archive; it must be correct only before the
stream completes.
If you don't want to have to generate this yourself, consider extending the
ZipPassThrough class and overriding its process() method, or using one of
ZipDeflate or AsyncZipDeflate.
___
### extra
• `Optional` **extra**: Record\<number, Uint8Array>
*Inherited from [ZipAttributes](zipattributes.md).[extra](zipattributes.md#extra)*
Extra metadata to add to the file. This field is defined by PKZIP's APPNOTE.txt,
section 4.4.28. At most 65,535 bytes may be used in each ID. The ID must be an
integer between 0 and 65,535, inclusive.
This field is incredibly rare and almost never needed except for compliance with
proprietary standards and software.
___
### filename
• **filename**: string
The filename to associate with the data provided to this stream. If you
want a file in a subdirectory, use forward slashes as a separator (e.g.
`directory/filename.ext`). This will still work on Windows.
___
### flag
• `Optional` **flag**: number
Bits 1 and 2 of the general purpose bit flag, specified in PKZIP's
APPNOTE.txt, section 4.4.4. Should be between 0 and 3. This is unlikely
to be necessary.
___
### mtime
• `Optional` **mtime**: GzipOptions[\"mtime\"]
*Inherited from [ZipAttributes](zipattributes.md).[mtime](zipattributes.md#mtime)*
When the file was last modified. Defaults to the current time.
___
### ondata
• `Optional` **ondata**: [AsyncFlateStreamHandler](../README.md#asyncflatestreamhandler)
The handler to be called when data is added. After passing this stream to
the ZIP file object, this handler will always be defined. To call it:
`stream.ondata(error, chunk, final)`
error = any error that occurred (null if there was no error)
chunk = a Uint8Array of the data that was added (null if there was an
error)
final = boolean, whether this is the final chunk in the stream
___
### os
• `Optional` **os**: number
*Inherited from [ZipAttributes](zipattributes.md).[os](zipattributes.md#os)*
The operating system of origin for this file. The value is defined
by PKZIP's APPNOTE.txt, section 4.4.2.2. For example, 0 (the default)
is MS/DOS, 3 is UNIX, 19 is macOS.
___
### size
• **size**: number
The size of the file in bytes. This attribute may be invalid after
the file is added to the ZIP archive; it must be correct only before the
stream completes.
If you don't want to have to compute this yourself, consider extending the
ZipPassThrough class and overriding its process() method, or using one of
ZipDeflate or AsyncZipDeflate.
___
### terminate
• `Optional` **terminate**: [AsyncTerminable](asyncterminable.md)
A method called when the stream is no longer needed, for clean-up
purposes. This will not always be called after the stream completes,
so you may wish to call this.terminate() after the final chunk is
processed if you have clean-up logic.
|
