React Native

Get the Total Size of an IMAP Message

Demonstrates the Chilkat Imap.GetMailSize method, which returns the complete server-reported size of a message in bytes, including attachment data. The only argument is the Email. This example fetches only the headers and prints the full message size.

Background: The server reports each message's total size, so this value is available even when only the headers were downloaded. That lets a client show a size column in a message list, sort by size, or warn the user before downloading an unusually large message — all without fetching the full body first.

Chilkat React Native Downloads

Download Chilkat for React Native

React Native

import { Email, Imap } from '@chilkat/react-native'

async function chilkatExample() {
  // Demonstrates the Imap.GetMailSize method, which returns the complete server-reported size
  // of a message in bytes, including attachments.  The only argument is the Email.

  const imap = new Imap();

  imap.ssl = true;
  imap.port = 993;

  try {
    await imap.connectAsync('imap.example.com');
  } catch {
    console.log(imap.lastErrorText);
    return;
  }

  try {
    await imap.loginAsync('user@example.com', 'myPassword');
  } catch {
    console.log(imap.lastErrorText);
    return;
  }

  try {
    await imap.selectMailboxAsync('Inbox');
  } catch {
    console.log(imap.lastErrorText);
    return;
  }

  // Fetch only the message headers.  Attachment bodies are NOT downloaded, but the ckx-imap-*
  // metadata describing the attachments is present, so the attachment info methods still work.
  const headersOnly = true;
  const useUid = false;
  const seqNum = 1;
  const email = new Email();
  try {
    await imap.fetchEmailAsync(headersOnly, seqNum, useUid, email);
  } catch {
    console.log(imap.lastErrorText);
    return;
  }

  const sizeBytes = imap.getMailSize(email);
  console.log(`Total message size: ${sizeBytes} bytes`);

  try {
    await imap.disconnectAsync();
  } catch {
    console.log(imap.lastErrorText);
    return;
  }
}