https://github.com/knowledgecode/formdatabuilder
An alternative FormData object for Web Workers
https://github.com/knowledgecode/formdatabuilder
Last synced: 3 months ago
JSON representation
An alternative FormData object for Web Workers
- Host: GitHub
- URL: https://github.com/knowledgecode/formdatabuilder
- Owner: knowledgecode
- License: mit
- Created: 2015-03-21T11:23:03.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2015-06-22T14:59:18.000Z (almost 10 years ago)
- Last Synced: 2025-03-01T02:42:55.036Z (4 months ago)
- Language: JavaScript
- Homepage:
- Size: 418 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FormDataBuilder [](https://circleci.com/gh/knowledgecode/formdatabuilder)
This is an alternative [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData) object in Web Workers. It's not a polyfill, but it has similar interface and can be created blob to send via XHR2.
## WHY
When we upload files via multipart/form-data, `FormData` object is very useful. However according to my investigation, in Web Workers it seems not to be able to use it except Chrome for now. It would be better if could create the polyfill, but it's probably impossible because at least there is a problem with converting to string from binary.
## API
### Constructor
```javascript
var form = new FormDataBuilder();
```
### append(name, value)
```javascript
form.append('name', 'John Smith');
form.append('photo', file);
```
### getBlob()
```javascript
var blob = form.getBlob();
```
### type
```javascript
xhr.setRequestHeader('Content-Type', form.type);
```
## Example
```javascript
importScripts('FormDataBuilder.js');
self.onmessage = function (evt) {
var profile = evt.data,
form = FormData ? new FormData() : new FormDataBuilder();
form.append('name', profile.name); // => String
form.append('email', profile.email); // => String
form.append('photo', profile.file); // => File
var xhr = new XMLHttpRequest(),
url = 'http://example.com/upload';
xhr.onload = function () {
if (xhr.readyState === 4) {
if (xhr.status === 200) {
postMessage(xhr.responseText);
} else {
postMessage('error');
}
}
};
xhr.open('POST', url, true);
if (form.type) {
xhr.setRequestHeader('Content-Type', form.type);
}
xhr.send(form.getBlob ? form.getBlob() : form);
};
```
## Browser Support
Chrome, Android 4.4+, Firefox, Safari 6+, Opera, and Internet Explorer 10+.
## License
MIT