React Native

Close a Remote SFTP File or Directory Handle

Demonstrates the Chilkat SFtp.CloseHandle method, which closes a remote file or directory handle previously returned by OpenFile or OpenDir. The only argument is the handle.

Background: Every opened handle corresponds to state the server holds, and servers cap how many a session may keep open at once, so a long-running program that forgets to close handles will eventually start failing to open new ones. Closing also ensures buffered writes are committed. Once closed, a handle is invalid and must not be reused.

Chilkat React Native Downloads

Download Chilkat for React Native

React Native

import { SFtp } from '@chilkat/react-native'

async function chilkatExample() {
  // Demonstrates the SFtp.CloseHandle method, which closes a remote file or directory handle.  The
  // only argument is the handle returned by OpenFile or OpenDir.

  const sftp = new SFtp();

  // Connect, authenticate, and initialize the SFTP subsystem.
  const port = 22;
  try {
    await sftp.connectAsync('sftp.example.com', port);
  } catch {
    console.log(sftp.lastErrorText);
    return;
  }

  // Normally you would not hard-code the password in source.  You should instead obtain it
  // from an interactive prompt, environment variable, or a secrets vault.
  const password = 'mySshPassword';

  try {
    await sftp.authenticatePwAsync('mySshLogin', password);
  } catch {
    console.log(sftp.lastErrorText);
    return;
  }

  try {
    await sftp.initializeSftpAsync();
  } catch {
    console.log(sftp.lastErrorText);
    return;
  }

  // Open a remote file, obtaining a handle.
  let handle: string;
  try {
    handle = await sftp.openFileAsync('subdir/data.txt', 'readOnly', 'openExisting');
  } catch {
    console.log(sftp.lastErrorText);
    return;
  }

  // ... use the handle ...

  // Close the handle to release the server-side resource.  A handle should not be used after it
  // is closed.
  try {
    await sftp.closeHandleAsync(handle);
  } catch {
    console.log(sftp.lastErrorText);
    return;
  }

  console.log('Handle closed.');

  sftp.disconnect();
}