Before determining whether an object exists, your account must have the tos:GetObject permission. For specific operations, please refer to the Permission Configuration Guide.

Sample Code

import { TosClient, TosClientError, TosServerError } from '@volcengine/tos_harmonyos_sdk';​
​
​
const client = new TosClient({​
  accessKeyId: "Provide your ak", ​
  accessKeySecret: "Provide your sk", ​
  securityToken: 'Provide your securityToken',​
  region: "Provide your region", ​
  endpoint: "Provide your endpoint", ​
});​
​
function handleError(error) {​
  if (error instanceof TosClientError) {​
    console.log('Client Err Name:', error.name);​
    console.log('Client Err Msg:', error.message);​
    console.log('Client Err Stack:', error.stack);​
  } else if (error instanceof TosServerError) {​
    console.log('Request ID:', error.requestId);​
    console.log('Response Status Code:', error.statusCode);​
    console.log('Response Status Code:', error.statusCode);​
    console.log('Response Header:', error.headers);​
    console.log('Response Err Code:', error.code);​
    console.log('Response Err Msg:', error.message);​
  } else {​
    console.log('unexpected exception, message: ', error);​
  }​
}​
​
async function main() {​
  try {​
    const bucketName = 'node-sdk-test-bucket';​
    ​
    const objectKey = 'example_dir/example.txt';​
​
    const res = await client.headObject({​
      Bucket: bucketName,​
      Key: objectKey,​
    });​
    console.log('The object exists.');​
    console.log('headObject Request ID:', res.RequestId);​
  } catch (error) {​
    if (error instanceof TosServerError) {​
      if (error.StatusCode === 404) {​
        ​
        console.log(`The object doesn't exist`);​
        return;​
      }​
    }​
​
    handleError(error);​
  }​
}​
​
main();​

Relevant Documentation

Regarding the API interface for determining whether an object exists, please refer to HeadObject.

Last updated: 2025.09.26 19:05:15

Public security network record in Beijing: No. 11010802032137