![Introducing Enhanced Alert Actions and Triage Functionality](https://cdn.sanity.io/images/cgdhsj6q/production/fe71306d515f85de6139b46745ea7180362324f0-2530x946.png?w=800&fit=max&auto=format)
Product
Introducing Enhanced Alert Actions and Triage Functionality
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
@capacitor-community/http
Advanced tools
Readme
@capacitor-community/http
Capacitor community plugin for native HTTP requests, file download/uploads, and cookie management.
Maintainer | GitHub | Social |
---|---|---|
Max Lynch | mlynch | @maxlynch |
Thomas Vidas | thomasvidas | @thomasvidas |
npm install @capacitor-community/http
npx cap sync
For Capacitor 2.x projects, you will need to install a version less than 1.0.0. You can do that by specifying the version in your package.json
or installing like this. The latest 2.x compatible version is 0.3.1
.
npm install @capacitor-community/http@0.x
In most cases no configuration is required for this plugin. If the Android application connects with use the self-signed certificates or without encryption, see Network security configuration article.
To use the plugin while fully supporting the web version, import and use it like this:
import { Http } from '@capacitor-community/http';
// Example of a GET request
const doGet = () => {
const options = {
url: 'https://example.com/my/api',
headers: { 'X-Fake-Header': 'Max was here' },
params: { size: 'XL' },
};
const response: HttpResponse = await Http.get(options);
// or...
// const response = await Http.request({ ...options, method: 'GET' })
};
// Example of a POST request. Note: data
// can be passed as a raw JS Object (must be JSON serializable)
const doPost = () => {
const options = {
url: 'https://example.com/my/api',
headers: { 'X-Fake-Header': 'Thomas was here' },
data: { foo: 'bar', cool: true },
};
const response: HttpResponse = await Http.post(options);
// or...
// const response = await Http.request({ ...options, method: 'POST' })
};
const setCookie = async () => {
const options = {
url: 'http://example.com',
key: 'language',
value: 'en',
};
await Http.setCookie(options);
};
const deleteCookie = async () => {
const options = {
url: 'http://example.com',
key: 'language',
};
await Http.deleteCookie(options);
};
const clearCookies = async () => {
await Http.clearCookies({ url: 'http://example.com' });
};
const getCookies = async () => {
const cookies: HttpCookie[] = await Http.getCookies({
url: 'http://example.com',
});
};
const downloadFile = async () => {
const options = {
url: 'https://example.com/path/to/download.pdf',
filePath: 'document.pdf',
fileDirectory: Directory.Downloads,
// Optional
method: 'GET',
};
// Writes to local filesystem
const response: HttpDownloadFileResult = await Http.downloadFile(options);
// Then read the file
if (response.path) {
const read = await Filesystem.readFile({
path: 'download.pdf',
directory: Directory.Downloads,
});
}
};
const uploadFile = async () => {
const options = {
url: 'https://example.com/path/to/upload.pdf',
name: 'myFile',
filePath: 'document.pdf',
fileDirectory: FilesystemDirectory.Downloads,
};
const response: HttpUploadFileResult = await Http.uploadFile();
};
You can view the API Reference generated by TypeDoc here: https://capacitor-community.github.io/http/docs/classes/web.httpweb.html
As of iOS 14, you cannot use 3rd party cookies by default. There is an open issue on the Capacitor Core repo on properly patching in cookies on iOS. For now, you must specify a domain of for the cookie you are saving to properly save and send them via requests. You can also add the following lines to your Info.plist
file to get better support for cookies on iOS. You can add up to 10 domains.
<key>WKAppBoundDomains</key>
<array>
<string>www.mydomain.com</string>
<string>api.mydomain.com</string>
<string>www.myothercooldomain.com</string>
</array>
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
FAQs
A native HTTP plugin for CORS-free requests and file transfers
The npm package @capacitor-community/http receives a total of 9,024 weekly downloads. As such, @capacitor-community/http popularity was classified as popular.
We found that @capacitor-community/http demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 35 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.