Skip to content

Node.js library for fetching the size of a file from a given URL using either HTTP or HTTPS protocols. It returns the file size in a human-readable format such as "1.23 MB".

License

Notifications You must be signed in to change notification settings

rn0x/file_size_url

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

file_size_url

NPM version

NPM monthly downloads

NPM total downloads

repository-open-graph-template

file_size_url is a simple Node.js library for fetching the size of a file from a given URL using either HTTP or HTTPS protocols. It returns the file size in a human-readable format such as "1.23 MB".

0 dependencies.

Installation

You can install the library via npm:

npm install file_size_url

Alternatively, if you have the source code, you can directly use the function in your Node.js project:

# Simply copy the source code file to your project directory

Usage

Importing and Using the Library

import fileSizeUrl from 'file_size_url';

fileSizeUrl("https://example.com/file.zip")
  .then(size => console.log(`File size: ${size}`))
  .catch(error => console.error(`Error: ${error.message}`));

Example with telegraf (Telegram Bot)

You can integrate file_size_url with telegraf to fetch and display file sizes in your Telegram bot:

import { Telegraf } from 'telegraf';
import fileSizeUrl from 'file_size_url';

const bot = new Telegraf('<YOUR_BOT_TOKEN>');

bot.command('filesize', async (ctx) => {
  const url = ctx.message.text.split(' ')[1];
  if (!url) return ctx.reply('Please provide a URL.');

  try {
    const size = await fileSizeUrl(url);
    ctx.reply(`File size: ${size}`);
  } catch (error) {
    ctx.reply(`Error: ${error.message}`);
  }
});

bot.launch();

Example with express.js

You can use file_size_url in an express.js server to get file sizes via an API:

import express from 'express';
import fileSizeUrl from 'file_size_url';

const app = express();

app.get('/filesize', (req, res) => {
  const { url } = req.query;
  if (!url) return res.status(400).send('URL parameter is required');

  fileSizeUrl(url)
    .then(size => res.send(`File size: ${size}`))
    .catch(error => res.status(500).send(`Error: ${error.message}`));
});

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

Using file_size_url in a Loop

You can easily use file_size_url inside a loop to fetch file sizes from multiple URLs:

import fileSizeUrl from './file_size_url.js';

const urls = [
  'https://example.com/file1.zip',
  'https://example.com/file2.zip',
  'https://example.com/file3.zip'
];

urls.forEach(async (url) => {
  try {
    const size = await fileSizeUrl(url);
    console.log(`File size for ${url}: ${size}`);
  } catch (error) {
    console.error(`Error fetching size for ${url}: ${error.message}`);
  }
});

Using file_size_url with Promise.all

Fetch file sizes concurrently for multiple URLs using Promise.all:

import fileSizeUrl from './file_size_url.js';

const urls = [
  'https://example.com/file1.zip',
  'https://example.com/file2.zip',
  'https://example.com/file3.zip'
];

Promise.all(urls.map(url => fileSizeUrl(url)))
  .then(sizes => {
    sizes.forEach((size, index) => {
      console.log(`File size for ${urls[index]}: ${size}`);
    });
  })
  .catch(error => console.error(`Error: ${error.message}`));

API Reference

fileSizeUrl(url)

Fetches the file size from a given URL.

Parameters

  • url (string): The URL of the file.

Returns

  • Promise: Resolves with the file size as a formatted string (e.g., "1.23 MB"). If an error occurs, the promise is rejected with an error message.

Example

fileSizeUrl("https://example.com/file.zip")
  .then(size => console.log(`File size: ${size}`))
  .catch(error => console.error(`Error: ${error.message}`));

Error Handling

  • Invalid URL: If the URL is invalid or missing.
  • The address should be http or https: If the protocol is not supported.
  • Failed to get file size, status code: <statusCode>: If the HTTP status code is not 200.
  • Couldn't retrieve file size from headers: If the content-length header is missing or invalid.

formatBytes(bytes)

Formats bytes into a human-readable string.

Parameters

  • bytes (number): The number of bytes.

Returns

  • string: The formatted size string (e.g., "1.23 MB").

Example

console.log(formatBytes(12345678)); // Output: "11.77 MB"

Notes

  • Make sure the URL starts with http:// or https://.
  • The library is designed to work only in Node.js environments that support the native http and https modules.

License

This library is available under the MIT License.


Arabic Documentation

About

Node.js library for fetching the size of a file from a given URL using either HTTP or HTTPS protocols. It returns the file size in a human-readable format such as "1.23 MB".

Topics

Resources

License

Stars

Watchers

Forks