NativeScript Resources and Info

New to NativeScript?

Visit the free getting started tutorials on nativescript.org for JavaScript or Angular.

My plugin is missing!

Kindly note that we filter out plugins that:

are marked as deprecated;
are marked as insecure (per nsp);
have a missing or improperly formatted package.json;
are missing the "nativescript" node in their package.json file (per plugin specifications);
do not have a public repository on GitHub.

Other NativeScript plugin sources:

nativescript-background-http-cancelable
by NativeScript

A cross platform plugin for [the NativeScript framework](http://www.nativescript.org), that provides background upload for iOS and Android.

$ tns plugin add nativescript-background-http-cancelable

Star Issue
View Plugin on GitHub

Rate Plugin:

Background Upload NativeScript plugin

A cross platform plugin for the NativeScript framework, that provides background upload for iOS and Android.

There is a stock NativeScript http module that can handle GET/POST requests that work with strings and JSONs. It however comes short in features when it comes to really large files.

The plugin uses NSURLSession with background session configuration for iOS; and for android - the alexbbb/android-upload-service that implements an IntentService.

Installation

tns plugin add nativescript-background-http

Usage

The below attached code snippets demonstrate how to use nativescript-background-http, while uploading single or multiple files.

uploadFile

uploading sigle file to the service

import * as bghttp from "nativescript-background-http";
var session = bghttp.session("image-upload");

.....
var request = {
		url: url,
		method: "POST",
		headers: {
			"Content-Type": "application/octet-stream",
			"File-Name": name
		},
		description: description
	};

	if (should_fail) {
		request.headers["Should-Fail"] = true;
	}

let task: bghttp.Task;
task = session.uploadFile(file, request);

multipartUpload

uploading multiple files while using nativescript-background-http. Make sure all params sent to multipartUpload have string values.

import * as bghttp from "nativescript-background-http";
var session = bghttp.session("image-upload");

.....
var request = {
		url: url,
		method: "POST",
		headers: {
			"Content-Type": "application/octet-stream",
			"File-Name": name
		},
		description: description
	};

	if (should_fail) {
		request.headers["Should-Fail"] = true;
	}

let task: bghttp.Task;
var params = [
			{ name: "test", value: "value" },
			{ name: "fileToUpload", filename: file, mimeType: 'image/jpeg' }
		];
task = session.multipartUpload(params, request);

To get advantage of the demo apps and test the functionality, you will have to start the server from demo-server folder part of the repository. To do so, execute cd demo-server && npm run start command in a terminal.

Contribute

We love PRs! Check out the contributing guidelines. If you want to contribute, but you are not sure where to start - look for issues labeled help wanted.

Get Help

Please, use github issues strictly for reporting bugs or requesting features. For general questions and support, check out Stack Overflow or ask our experts in NativeScript community Slack channel.

License

Apache License Version 2.0, January 2004

Quality metric based on:

Has README? Has license? Has .gitignore and friends?
Is the version stable (> 1.x.x)? Is it deprecated?
Has tests? Whats their coverage %? Is build passing?
Has outdated dependencies? Do they have vulnerabilities?
Has custom website? Has badges?
Does the project have linters configured?
What's the code complexity score?