Skip to main content
Este guia de referência explica a classe Client da biblioteca object-storage e fornece exemplos de código para seus métodos.

​
Client

A classe Client gerencia as interações com o Replit App Storage. Esta classe possui métodos para realizar operações em arquivos em um bucket. Para importar a classe da biblioteca, adicione a seguinte linha ao seu código JavaScript: 
import { Client } from "@replit/object-storage";
Use o seguinte código para criar uma instância de Client que interage com o Replit Object Storage: 
const client = new Client();

​
Construtores

constructor
  • new Client(options?): Client
Cria uma nova instância de Client para interagir com o Replit App Storage. Parâmetros
NomeTipoDescrição
options?ClientOptionsOpções de configuração para inicializar o cliente.
Retorna Client

​
Métodos

​
copy

  • copy(objectName, destObjectName): Promise<Result<null, RequestError>>
Copia um objeto dentro do mesmo bucket. Este método sobrescreve qualquer objeto existente no caminho de destino. Parâmetros
NomeTipoDescrição
objectNamestringO caminho completo do objeto a ser copiado.
destObjectNamestringO caminho completo para onde o objeto será copiado.
Retorna Promise<Result<null, RequestError>>

​
delete

  • delete(objectName, options?): Promise<Result<null, RequestError>>
Exclui um objeto do bucket. Parâmetros
NomeTipoDescrição
objectNamestringO caminho completo do objeto a ser excluído.
options?DeleteOptionsConfigurações para a operação de exclusão.
Retorna Promise<Result<null, RequestError>>

​
downloadAsBytes

  • downloadAsBytes(objectName, options?): Promise<Result<Buffer, RequestError>>
Faz o download de um objeto e retorna seu conteúdo bruto como um buffer. Parâmetros
NomeTipoDescrição
objectNamestringO caminho completo do objeto a ser baixado.
options?DownloadOptionsConfigurações para a operação de download.
Retorna Promise<Result<Buffer, RequestError>>

​
downloadAsStream

  • downloadAsStream(objectName, options?): Readable
Cria um stream legível do conteúdo do objeto. O stream emite quaisquer erros encontrados durante o download. Parâmetros
NomeTipoDescrição
objectNamestringO caminho completo do objeto a ser baixado.
options?DownloadOptionsConfigurações para a operação de download.
Retorna Readable

​
downloadAsText

  • downloadAsText(objectName, options?): Promise<Result<string, RequestError>>
Faz o download de um objeto e retorna seu conteúdo como uma string. Parâmetros
NomeTipoDescrição
objectNamestringO caminho completo do objeto a ser baixado.
options?DownloadOptionsConfigurações para a operação de download.
Retorna Promise<Result<string, RequestError>>

​
downloadToFilename

  • downloadToFilename(objectName, destFilename, options?): Promise<Result<null, RequestError>>
Faz o download de um objeto e o salva no local especificado no sistema de arquivos local. Parâmetros
NomeTipoDescrição
objectNamestringO caminho completo do objeto a ser baixado.
destFilenamestringO caminho no sistema de arquivos local onde o objeto baixado será gravado.
options?DownloadOptionsConfigurações para a operação de download.
Retorna Promise<Result<null, RequestError>>

​
exists

  • exists(objectName): Promise<Result<boolean, RequestError>>
Verifica se um objeto existe no bucket. Parâmetros
NomeTipoDescrição
objectNamestringO caminho completo do objeto a ser verificado.
Retorna Promise<Result<boolean, RequestError>>

​
getBucket

  • getBucket(): Promise<Bucket>
Retorna Promise<Bucket>

​
init

  • init(bucketId?): Promise<Bucket>
Parâmetros
NomeTipo
bucketId?string
Retorna Promise<Bucket>

​
list

  • list(options?): Promise<Result<StorageObject[], RequestError>>
Retorna uma lista de todos os objetos no bucket. Parâmetros
NomeTipoDescrição
options?ListOptionsConfigurações para a operação de listagem.
Retorna Promise<Result<StorageObject[], RequestError>>

​
mapUploadOptions

  • mapUploadOptions(options?): undefined | UploadOptions
Parâmetros
NomeTipo
options?UploadOptions
Retorna undefined | UploadOptions

​
uploadFromBytes

  • uploadFromBytes(objectName, contents, options?): Promise<Result<null, RequestError>>
Faz o upload de um objeto usando sua representação em bytes na memória. Este método sobrescreve qualquer objeto existente com o mesmo nome. Parâmetros
NomeTipoDescrição
objectNamestringO caminho de destino completo do objeto.
contentsBufferO conteúdo bruto do objeto em forma de bytes.
options?UploadOptionsConfigurações para a operação de upload.
Retorna Promise<Result<null, RequestError>>

​
uploadFromFilename

  • uploadFromFilename(objectName, srcFilename, options?): Promise<Result<null, RequestError>>
Faz o upload de um arquivo do sistema de arquivos local para o bucket. Este método sobrescreve qualquer objeto existente com o mesmo nome. Parâmetros
NomeTipoDescrição
objectNamestringO caminho de destino completo do objeto.
srcFilenamestringO caminho do arquivo no sistema de arquivos local a ser enviado.
options?UploadOptionsConfigurações para a operação de upload.
Retorna Promise<Result<null, RequestError>>

​
uploadFromStream

  • uploadFromStream(objectName, stream, options?): Promise<void>
Faz o upload de um objeto lendo seu conteúdo a partir do stream fornecido. O stream emite quaisquer erros encontrados durante o upload. Este método sobrescreve qualquer objeto existente com o mesmo nome. Parâmetros
NomeTipoDescrição
objectNamestringO caminho de destino completo do objeto.
streamReadableUm stream legível a partir do qual o conteúdo do objeto será lido.
options?UploadOptionsConfigurações para a operação de upload.
Retorna Promise<void>

​
uploadFromText

  • uploadFromText(objectName, contents, options?): Promise<Result<null, RequestError>>
Faz o upload de um objeto usando sua representação em texto na memória. Este método sobrescreve qualquer objeto existente com o mesmo nome. Parâmetros
NomeTipoDescrição
objectNamestringO caminho de destino completo do objeto.
contentsstringO conteúdo do objeto em forma de texto.
options?UploadOptionsConfigurações para a operação de upload.
Retorna Promise<Result<null, RequestError>>

​
Exemplos de métodos

As seções a seguir fornecem exemplos de código para gerenciar seus arquivos usando o SDK do Replit Object Storage.

​
Recuperar um objeto como texto

const { ok, value: textValue, error } = await client.downloadAsText('file.json');
if (!ok) {
    // ... tratar erro ...
}

​
Recuperar um objeto como representação bruta em bytes

const { ok, value: bytesValue, error } = await client.downloadAsBytes('file.png');
if (!ok) {
    // ... tratar erro ...
}

​
Recuperar um objeto a partir de um stream

const { ok, value: stream, error } = await client.downloadAsStream('file.json');
if (!ok) {
    // ... tratar erro ...
}

​
Baixar um objeto para o sistema de arquivos

const { ok, error } = await client.downloadToFilename('file.json', destFilename);
if (!ok) {
    // ... tratar erro ...
}

​
Listar objetos no bucket

const { ok, value, error } = await client.list();
if (!ok) {
    // ... tratar erro ...
}

​
Fazer upload de um objeto a partir de texto

const { ok, error } = await client.uploadFromText('file.json', data);
if (!ok) {
    // ... tratar erro ...
}

​
Fazer upload de um objeto como bytes

const { ok, error } = await client.uploadFromBytes('file.png', data);
if (!ok) {
    // ... tratar erro ...
}

​
Fazer upload de um objeto a partir do sistema de arquivos

const { ok, error } = await client.uploadFromFilename('file.json', srcFilename);
if (!ok) {
    // ... tratar erro ...
}

​
Fazer upload de um objeto a partir de um stream

const { ok, error } = await client.uploadFromStream('file.json', stream);
if (!ok) {
    // ... tratar erro ...
}

​
Excluir um objeto do bucket

const { ok, error } = await client.delete('file.json');
if (!ok) {
    // ... tratar erro ...
}