new NetEntity()
Represents messages that are sent or received over the internet. See RFC 2045.
Methods
attach(attachment)
Attach a entity
| Name | Type | Description |
|---|---|---|
attachment | $k.NetEntity |
If the entity is not a valid attachment
attachments() → {Array.<$k.NetEntity>}
Returns the attached entities
- Type:
- Array.<$k.NetEntity>
base64String() → {string}
Get the binay contents as base64-encoded string. Returns undefined if the contents is not binary
- Type:
- string
charset() → {string}
Returns the charset
- Type:
- string
contentDisposition() → {string}
Returns the content disposition
- Type:
- string
contentLength() → {number}
Returns the content length
- Type:
- number
contentType() → {string}
Returns the content type (only the media type part)
- Type:
- string
dataUrl() → {string}
Returns the entity bytes as a data URL, or undefined if the entity is not binary
- Type:
- string
debugString() → {string}
Prints the entity, except binary contents, for debugging purposes
- Type:
- string
filename() → {string}
Returns the filename part of the content disposition field
- Type:
- string
formData() → {object}
Get all form fields (multipart/form-data or application/x-www-form-urlencoded). The property names correspond to the field names. The property values are either strings (if the form is of type application/x-www-form-urlencoded) or NetEntities (multipart/form-data)
- See
- Type:
- object
headerField(fieldName) → {string}
Get the value of the field of the request header. Returns undefined if the field does not exist
| Name | Type | Description |
|---|---|---|
fieldName | string |
The field value
- Type:
- string
headerFields() → {object}
Get all fields of the request header. Field names are always lower case
- Type:
- object
isBinary() → {boolean}
True if the entity has binary contents
- Type:
- boolean
removeHeaderField(fieldName)
Removes the field of the request heade
| Name | Type | Description |
|---|---|---|
fieldName | string |
- Since
- 5.0.3
setCharset(charset)
Set the charset
| Name | Type | Description |
|---|---|---|
charset | string |
If the charset is unknown
setContentDisposition(contentDisposition)
Set the content disposition
| Name | Type | Description |
|---|---|---|
contentDisposition | string |
setContentLength(length)
Set the content length
| Name | Type | Description |
|---|---|---|
length | number |
setContents(contents)
Set the contents of the entity. Also sets the content type and filename if known. The contents object can be a string, document ($k.TextDocument), a blob value ($k.Blob) or another NetEntity
| Name | Type | Description |
|---|---|---|
contents | Contents object |
setContentType(mediaType, charsetopt)
Set the content type
| Name | Type | Attributes | Description |
|---|---|---|---|
mediaType | string | Media type of the contents | |
charset | string | <optional> | Charset of the contents |
setFilename(filename)
Set the filename part of the content disposition field
| Name | Type | Description |
|---|---|---|
filename | string |
setHeaderField(fieldName, fieldValue)
Set the value of the field of the request header
| Name | Type | Description |
|---|---|---|
fieldName | string | |
fieldValue |
If the value does not match the type of the field
setText(text)
Set the text as the body
| Name | Type | Description |
|---|---|---|
text | string |
text(charsetopt) → {string}
Get the contents as string
| Name | Type | Attributes | Description |
|---|---|---|---|
charset | string | <optional> | Charset of the characters. Required for binary entities. Optional for text entities. |
- Type:
- string