List files in a paginated manner

Stay organized with collections Save and categorize content based on your preferences.

List objects in a bucket with no autopagination, showing how to move to the next set of objects.

Code sample


For more information, see the Cloud Storage Node.js API reference documentation.

 * TODO(developer): Uncomment the following lines before running the sample.
// The ID of your GCS bucket
// const bucketName = 'your-unique-bucket-name';

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

async function listFilesPaginated() {
  const bucket = storage.bucket(bucketName);
  const [files, queryForPage2] = await bucket.getFiles({autoPaginate: false});

  files.forEach(file => {

  // Page through the next set of results using "queryForPage2"
  if (queryForPage2 !== null) {
    const [files, queryForPage3] = await bucket.getFiles(queryForPage2);

    files.forEach(file => {

    // If necessary, continue cursoring using "queryForPage3"


What's next

To search and filter code samples for other Google Cloud products, see the Google Cloud sample browser.