0.1.0 • Published 5 years ago

@phoenix35/dirty-get v0.1.0

Weekly downloads
1
License
GPL-3.0-or-later
Repository
github
Last release
5 years ago

dirty-get

A simple utility package abstracting the native http.get with a promise.

DO NOT use this when you expect lengthy body contents. This puts the entirety of the body in memory.
Make actual use of streams.

If you need contents of an https: URL, use dirty-sec-get.
There will be no merge of the two packages to accept both protocols. Make your own or use a library.

How-to

const httpGet = require("@phoenix35/dirty-get");
const someText = await httpGet("http://skateipsum.com/get/1/0/text");

As it uses the native http module, url can be a string, an object accepted by http.get, or an URL instance.

When expecting binary data

The function returns an UTF-8 encoded string by default.
You can switch to a buffer representation by passing null as the second argument.

const someIcon = await httpGet("http://skateipsum.com/favicon.ico", null);

Licensing

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.