[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6XEW8CEWV1X7ZSMJRDJBAP8":3,"skill-same:01M6XEW8CEWV1X7ZSMJRDJBAP8":63},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":37,"linkOnly":38,"markdownContent":39,"markdownBody":40,"frontMatter":41,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":14,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":48,"install":49,"resources":62},"01M6XEW8CEWV1X7ZSMJRDJBAP8","azure-storage-blob-ts",null,"Azure Blob Storage JavaScript\u002FTypeScript SDK (@azure\u002Fstorage-blob) for blob operations. Use for uploading, downloading, listing, and managing blobs and containers.","sapsapshen\u002Fai-memory-router","sapsapshen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F20347959?v=4","01M6XDQEF1DP50DKF37H81J3J5","shenmian","01M6XDQEJPE41Y3DT2763X8ZJN",0,"MIT","https:\u002F\u002Fgithub.com\u002Fsapsapshen\u002Fai-memory-router\u002Fblob\u002Fmain\u002Fskills-store\u002Fcopilot\u002Fazure-storage-blob-ts\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36],"storage","blob","azure storage","azure","azure storage blob ts","use","2026","listing","blob storage","unknown","for","azure blob storage","community","typescript","operations","javascript","sdk","containers","2026-11-10 10:12:30",false,"---\nname: azure-storage-blob-ts\ndescription: Azure Blob Storage JavaScript\u002FTypeScript SDK (@azure\u002Fstorage-blob) for blob operations. Use for uploading, downloading, listing, and managing blobs and containers.\nrisk: unknown\nsource: community\ndate_added: '2026-02-27'\n---\n\n# @azure\u002Fstorage-blob (TypeScript\u002FJavaScript)\n\nSDK for Azure Blob Storage operations — upload, download, list, and manage blobs and containers.\n\n## Installation\n\n```bash\nnpm install @azure\u002Fstorage-blob @azure\u002Fidentity\n```\n\n**Current Version**: 12.x  \n**Node.js**: >= 18.0.0\n\n## Environment Variables\n\n```bash\nAZURE_STORAGE_ACCOUNT_NAME=\u003Caccount-name>\nAZURE_STORAGE_ACCOUNT_KEY=\u003Caccount-key>\n# OR connection string\nAZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=...\n```\n\n## Authentication\n\n### DefaultAzureCredential (Recommended)\n\n```typescript\nimport { BlobServiceClient } from \"@azure\u002Fstorage-blob\";\nimport { DefaultAzureCredential } from \"@azure\u002Fidentity\";\n\nconst accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME!;\nconst client = new BlobServiceClient(\n  `https:\u002F\u002F${accountName}.blob.core.windows.net`,\n  new DefaultAzureCredential()\n);\n```\n\n### Connection String\n\n```typescript\nimport { BlobServiceClient } from \"@azure\u002Fstorage-blob\";\n\nconst client = BlobServiceClient.fromConnectionString(\n  process.env.AZURE_STORAGE_CONNECTION_STRING!\n);\n```\n\n### StorageSharedKeyCredential (Node.js only)\n\n```typescript\nimport { BlobServiceClient, StorageSharedKeyCredential } from \"@azure\u002Fstorage-blob\";\n\nconst accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME!;\nconst accountKey = process.env.AZURE_STORAGE_ACCOUNT_KEY!;\n\nconst sharedKeyCredential = new StorageSharedKeyCredential(accountName, accountKey);\nconst client = new BlobServiceClient(\n  `https:\u002F\u002F${accountName}.blob.core.windows.net`,\n  sharedKeyCredential\n);\n```\n\n### SAS Token\n\n```typescript\nimport { BlobServiceClient } from \"@azure\u002Fstorage-blob\";\n\nconst accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME!;\nconst sasToken = process.env.AZURE_STORAGE_SAS_TOKEN!; \u002F\u002F starts with \"?\"\n\nconst client = new BlobServiceClient(\n  `https:\u002F\u002F${accountName}.blob.core.windows.net${sasToken}`\n);\n```\n\n## Client Hierarchy\n\n```\nBlobServiceClient (account level)\n└── ContainerClient (container level)\n    └── BlobClient (blob level)\n        ├── BlockBlobClient (block blobs - most common)\n        ├── AppendBlobClient (append-only blobs)\n        └── PageBlobClient (page blobs - VHDs)\n```\n\n## Container Operations\n\n### Create Container\n\n```typescript\nconst containerClient = client.getContainerClient(\"my-container\");\nawait containerClient.create();\n\n\u002F\u002F Or create if not exists\nawait containerClient.createIfNotExists();\n```\n\n### List Containers\n\n```typescript\nfor await (const container of client.listContainers()) {\n  console.log(container.name);\n}\n\n\u002F\u002F With prefix filter\nfor await (const container of client.listContainers({ prefix: \"logs-\" })) {\n  console.log(container.name);\n}\n```\n\n### Delete Container\n\n```typescript\nawait containerClient.delete();\n\u002F\u002F Or delete if exists\nawait containerClient.deleteIfExists();\n```\n\n## Blob Operations\n\n### Upload Blob (Simple)\n\n```typescript\nconst containerClient = client.getContainerClient(\"my-container\");\nconst blockBlobClient = containerClient.getBlockBlobClient(\"my-file.txt\");\n\n\u002F\u002F Upload string\nawait blockBlobClient.upload(\"Hello, World!\", 13);\n\n\u002F\u002F Upload Buffer\nconst buffer = Buffer.from(\"Hello, World!\");\nawait blockBlobClient.upload(buffer, buffer.length);\n```\n\n### Upload from File (Node.js only)\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"uploaded-file.txt\");\nawait blockBlobClient.uploadFile(\"\u002Fpath\u002Fto\u002Flocal\u002Ffile.txt\");\n```\n\n### Upload from Stream (Node.js only)\n\n```typescript\nimport * as fs from \"fs\";\n\nconst blockBlobClient = containerClient.getBlockBlobClient(\"streamed-file.txt\");\nconst readStream = fs.createReadStream(\"\u002Fpath\u002Fto\u002Flocal\u002Ffile.txt\");\n\nawait blockBlobClient.uploadStream(readStream, 4 * 1024 * 1024, 5, {\n  \u002F\u002F bufferSize: 4MB, maxConcurrency: 5\n  onProgress: (progress) => console.log(`Uploaded ${progress.loadedBytes} bytes`),\n});\n```\n\n### Upload from Browser\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"browser-upload.txt\");\n\n\u002F\u002F From File input\nconst fileInput = document.getElementById(\"fileInput\") as HTMLInputElement;\nconst file = fileInput.files![0];\nawait blockBlobClient.uploadData(file);\n\n\u002F\u002F From Blob\u002FArrayBuffer\nconst arrayBuffer = new ArrayBuffer(1024);\nawait blockBlobClient.uploadData(arrayBuffer);\n```\n\n### Download Blob\n\n```typescript\nconst blobClient = containerClient.getBlobClient(\"my-file.txt\");\nconst downloadResponse = await blobClient.download();\n\n\u002F\u002F Read as string (browser & Node.js)\nconst downloaded = await streamToText(downloadResponse.readableStreamBody!);\n\nasync function streamToText(readable: NodeJS.ReadableStream): Promise\u003Cstring> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of readable) {\n    chunks.push(Buffer.from(chunk));\n  }\n  return Buffer.concat(chunks).toString(\"utf-8\");\n}\n```\n\n### Download to File (Node.js only)\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"my-file.txt\");\nawait blockBlobClient.downloadToFile(\"\u002Fpath\u002Fto\u002Flocal\u002Fdestination.txt\");\n```\n\n### Download to Buffer (Node.js only)\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"my-file.txt\");\nconst buffer = await blockBlobClient.downloadToBuffer();\nconsole.log(buffer.toString());\n```\n\n### List Blobs\n\n```typescript\n\u002F\u002F List all blobs\nfor await (const blob of containerClient.listBlobsFlat()) {\n  console.log(blob.name, blob.properties.contentLength);\n}\n\n\u002F\u002F List with prefix\nfor await (const blob of containerClient.listBlobsFlat({ prefix: \"logs\u002F\" })) {\n  console.log(blob.name);\n}\n\n\u002F\u002F List by hierarchy (virtual directories)\nfor await (const item of containerClient.listBlobsByHierarchy(\"\u002F\")) {\n  if (item.kind === \"prefix\") {\n    console.log(`Directory: ${item.name}`);\n  } else {\n    console.log(`Blob: ${item.name}`);\n  }\n}\n```\n\n### Delete Blob\n\n```typescript\nconst blobClient = containerClient.getBlobClient(\"my-file.txt\");\nawait blobClient.delete();\n\n\u002F\u002F Delete if exists\nawait blobClient.deleteIfExists();\n\n\u002F\u002F Delete with snapshots\nawait blobClient.delete({ deleteSnapshots: \"include\" });\n```\n\n### Copy Blob\n\n```typescript\nconst sourceBlobClient = containerClient.getBlobClient(\"source.txt\");\nconst destBlobClient = containerClient.getBlobClient(\"destination.txt\");\n\n\u002F\u002F Start copy operation\nconst copyPoller = await destBlobClient.beginCopyFromURL(sourceBlobClient.url);\nawait copyPoller.pollUntilDone();\n```\n\n## Blob Properties & Metadata\n\n### Get Properties\n\n```typescript\nconst blobClient = containerClient.getBlobClient(\"my-file.txt\");\nconst properties = await blobClient.getProperties();\n\nconsole.log(\"Content-Type:\", properties.contentType);\nconsole.log(\"Content-Length:\", properties.contentLength);\nconsole.log(\"Last Modified:\", properties.lastModified);\nconsole.log(\"ETag:\", properties.etag);\n```\n\n### Set Metadata\n\n```typescript\nawait blobClient.setMetadata({\n  author: \"John Doe\",\n  category: \"documents\",\n});\n```\n\n### Set HTTP Headers\n\n```typescript\nawait blobClient.setHTTPHeaders({\n  blobContentType: \"text\u002Fplain\",\n  blobCacheControl: \"max-age=3600\",\n  blobContentDisposition: \"attachment; filename=download.txt\",\n});\n```\n\n## SAS Token Generation (Node.js only)\n\n### Generate Blob SAS\n\n```typescript\nimport {\n  BlobSASPermissions,\n  generateBlobSASQueryParameters,\n  StorageSharedKeyCredential,\n} from \"@azure\u002Fstorage-blob\";\n\nconst sharedKeyCredential = new StorageSharedKeyCredential(accountName, accountKey);\n\nconst sasToken = generateBlobSASQueryParameters(\n  {\n    containerName: \"my-container\",\n    blobName: \"my-file.txt\",\n    permissions: BlobSASPermissions.parse(\"r\"), \u002F\u002F read only\n    startsOn: new Date(),\n    expiresOn: new Date(Date.now() + 3600 * 1000), \u002F\u002F 1 hour\n  },\n  sharedKeyCredential\n).toString();\n\nconst sasUrl = `https:\u002F\u002F${accountName}.blob.core.windows.net\u002Fmy-container\u002Fmy-file.txt?${sasToken}`;\n```\n\n### Generate Container SAS\n\n```typescript\nimport { ContainerSASPermissions, generateBlobSASQueryParameters } from \"@azure\u002Fstorage-blob\";\n\nconst sasToken = generateBlobSASQueryParameters(\n  {\n    containerName: \"my-container\",\n    permissions: ContainerSASPermissions.parse(\"racwdl\"), \u002F\u002F read, add, create, write, delete, list\n    expiresOn: new Date(Date.now() + 24 * 3600 * 1000), \u002F\u002F 24 hours\n  },\n  sharedKeyCredential\n).toString();\n```\n\n### Generate Account SAS\n\n```typescript\nimport {\n  AccountSASPermissions,\n  AccountSASResourceTypes,\n  AccountSASServices,\n  generateAccountSASQueryParameters,\n} from \"@azure\u002Fstorage-blob\";\n\nconst sasToken = generateAccountSASQueryParameters(\n  {\n    services: AccountSASServices.parse(\"b\").toString(), \u002F\u002F blob\n    resourceTypes: AccountSASResourceTypes.parse(\"sco\").toString(), \u002F\u002F service, container, object\n    permissions: AccountSASPermissions.parse(\"rwdlacupi\"), \u002F\u002F all permissions\n    expiresOn: new Date(Date.now() + 24 * 3600 * 1000),\n  },\n  sharedKeyCredential\n).toString();\n```\n\n## Blob Types\n\n### Block Blob (Default)\n\nMost common type for text and binary files.\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"document.pdf\");\nawait blockBlobClient.uploadFile(\"\u002Fpath\u002Fto\u002Fdocument.pdf\");\n```\n\n### Append Blob\n\nOptimized for append operations (logs, audit trails).\n\n```typescript\nconst appendBlobClient = containerClient.getAppendBlobClient(\"app.log\");\n\n\u002F\u002F Create the append blob\nawait appendBlobClient.create();\n\n\u002F\u002F Append data\nawait appendBlobClient.appendBlock(\"Log entry 1\\n\", 12);\nawait appendBlobClient.appendBlock(\"Log entry 2\\n\", 12);\n```\n\n### Page Blob\n\nFixed-size blobs for random read\u002Fwrite (VHDs).\n\n```typescript\nconst pageBlobClient = containerClient.getPageBlobClient(\"disk.vhd\");\n\n\u002F\u002F Create 512-byte aligned page blob\nawait pageBlobClient.create(1024 * 1024); \u002F\u002F 1MB\n\n\u002F\u002F Write pages (must be 512-byte aligned)\nconst buffer = Buffer.alloc(512);\nawait pageBlobClient.uploadPages(buffer, 0, 512);\n```\n\n## Error Handling\n\n```typescript\nimport { RestError } from \"@azure\u002Fstorage-blob\";\n\ntry {\n  await containerClient.create();\n} catch (error) {\n  if (error instanceof RestError) {\n    switch (error.statusCode) {\n      case 404:\n        console.log(\"Container not found\");\n        break;\n      case 409:\n        console.log(\"Container already exists\");\n        break;\n      case 403:\n        console.log(\"Access denied\");\n        break;\n      default:\n        console.error(`Storage error ${error.statusCode}: ${error.message}`);\n    }\n  }\n  throw error;\n}\n```\n\n## TypeScript Types Reference\n\n```typescript\nimport {\n  \u002F\u002F Clients\n  BlobServiceClient,\n  ContainerClient,\n  BlobClient,\n  BlockBlobClient,\n  AppendBlobClient,\n  PageBlobClient,\n\n  \u002F\u002F Authentication\n  StorageSharedKeyCredential,\n  AnonymousCredential,\n\n  \u002F\u002F SAS\n  BlobSASPermissions,\n  ContainerSASPermissions,\n  AccountSASPermissions,\n  AccountSASServices,\n  AccountSASResourceTypes,\n  generateBlobSASQueryParameters,\n  generateAccountSASQueryParameters,\n\n  \u002F\u002F Options & Responses\n  BlobDownloadResponseParsed,\n  BlobUploadCommonResponse,\n  ContainerCreateResponse,\n  BlobItem,\n  ContainerItem,\n\n  \u002F\u002F Errors\n  RestError,\n} from \"@azure\u002Fstorage-blob\";\n```\n\n## Best Practices\n\n1. **Use DefaultAzureCredential** — Prefer AAD over connection strings\u002Fkeys\n2. **Use streaming for large files** — `uploadStream`\u002F`downloadToFile` for files > 256MB\n3. **Set appropriate content types** — Use `setHTTPHeaders` for correct MIME types\n4. **Use SAS tokens for client access** — Generate short-lived tokens for browser uploads\n5. **Handle errors gracefully** — Check `RestError.statusCode` for specific handling\n6. **Use `*IfNotExists` methods** — For idempotent container\u002Fblob creation\n7. **Close clients** — Not required but good practice in long-running apps\n\n## Platform Differences\n\n| Feature | Node.js | Browser |\n|---------|---------|---------|\n| `StorageSharedKeyCredential` | ✅ | ❌ |\n| `uploadFile()` | ✅ | ❌ |\n| `uploadStream()` | ✅ | ❌ |\n| `downloadToFile()` | ✅ | ❌ |\n| `downloadToBuffer()` | ✅ | ❌ |\n| `uploadData()` | ✅ | ✅ |\n| SAS generation | ✅ | ❌ |\n| DefaultAzureCredential | ✅ | ❌ |\n| Anonymous\u002FSAS access | ✅ | ✅ |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n","# @azure\u002Fstorage-blob (TypeScript\u002FJavaScript)\n\nSDK for Azure Blob Storage operations — upload, download, list, and manage blobs and containers.\n\n## Installation\n\n```bash\nnpm install @azure\u002Fstorage-blob @azure\u002Fidentity\n```\n\n**Current Version**: 12.x  \n**Node.js**: >= 18.0.0\n\n## Environment Variables\n\n```bash\nAZURE_STORAGE_ACCOUNT_NAME=\u003Caccount-name>\nAZURE_STORAGE_ACCOUNT_KEY=\u003Caccount-key>\n# OR connection string\nAZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=...\n```\n\n## Authentication\n\n### DefaultAzureCredential (Recommended)\n\n```typescript\nimport { BlobServiceClient } from \"@azure\u002Fstorage-blob\";\nimport { DefaultAzureCredential } from \"@azure\u002Fidentity\";\n\nconst accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME!;\nconst client = new BlobServiceClient(\n  `https:\u002F\u002F${accountName}.blob.core.windows.net`,\n  new DefaultAzureCredential()\n);\n```\n\n### Connection String\n\n```typescript\nimport { BlobServiceClient } from \"@azure\u002Fstorage-blob\";\n\nconst client = BlobServiceClient.fromConnectionString(\n  process.env.AZURE_STORAGE_CONNECTION_STRING!\n);\n```\n\n### StorageSharedKeyCredential (Node.js only)\n\n```typescript\nimport { BlobServiceClient, StorageSharedKeyCredential } from \"@azure\u002Fstorage-blob\";\n\nconst accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME!;\nconst accountKey = process.env.AZURE_STORAGE_ACCOUNT_KEY!;\n\nconst sharedKeyCredential = new StorageSharedKeyCredential(accountName, accountKey);\nconst client = new BlobServiceClient(\n  `https:\u002F\u002F${accountName}.blob.core.windows.net`,\n  sharedKeyCredential\n);\n```\n\n### SAS Token\n\n```typescript\nimport { BlobServiceClient } from \"@azure\u002Fstorage-blob\";\n\nconst accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME!;\nconst sasToken = process.env.AZURE_STORAGE_SAS_TOKEN!; \u002F\u002F starts with \"?\"\n\nconst client = new BlobServiceClient(\n  `https:\u002F\u002F${accountName}.blob.core.windows.net${sasToken}`\n);\n```\n\n## Client Hierarchy\n\n```\nBlobServiceClient (account level)\n└── ContainerClient (container level)\n    └── BlobClient (blob level)\n        ├── BlockBlobClient (block blobs - most common)\n        ├── AppendBlobClient (append-only blobs)\n        └── PageBlobClient (page blobs - VHDs)\n```\n\n## Container Operations\n\n### Create Container\n\n```typescript\nconst containerClient = client.getContainerClient(\"my-container\");\nawait containerClient.create();\n\n\u002F\u002F Or create if not exists\nawait containerClient.createIfNotExists();\n```\n\n### List Containers\n\n```typescript\nfor await (const container of client.listContainers()) {\n  console.log(container.name);\n}\n\n\u002F\u002F With prefix filter\nfor await (const container of client.listContainers({ prefix: \"logs-\" })) {\n  console.log(container.name);\n}\n```\n\n### Delete Container\n\n```typescript\nawait containerClient.delete();\n\u002F\u002F Or delete if exists\nawait containerClient.deleteIfExists();\n```\n\n## Blob Operations\n\n### Upload Blob (Simple)\n\n```typescript\nconst containerClient = client.getContainerClient(\"my-container\");\nconst blockBlobClient = containerClient.getBlockBlobClient(\"my-file.txt\");\n\n\u002F\u002F Upload string\nawait blockBlobClient.upload(\"Hello, World!\", 13);\n\n\u002F\u002F Upload Buffer\nconst buffer = Buffer.from(\"Hello, World!\");\nawait blockBlobClient.upload(buffer, buffer.length);\n```\n\n### Upload from File (Node.js only)\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"uploaded-file.txt\");\nawait blockBlobClient.uploadFile(\"\u002Fpath\u002Fto\u002Flocal\u002Ffile.txt\");\n```\n\n### Upload from Stream (Node.js only)\n\n```typescript\nimport * as fs from \"fs\";\n\nconst blockBlobClient = containerClient.getBlockBlobClient(\"streamed-file.txt\");\nconst readStream = fs.createReadStream(\"\u002Fpath\u002Fto\u002Flocal\u002Ffile.txt\");\n\nawait blockBlobClient.uploadStream(readStream, 4 * 1024 * 1024, 5, {\n  \u002F\u002F bufferSize: 4MB, maxConcurrency: 5\n  onProgress: (progress) => console.log(`Uploaded ${progress.loadedBytes} bytes`),\n});\n```\n\n### Upload from Browser\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"browser-upload.txt\");\n\n\u002F\u002F From File input\nconst fileInput = document.getElementById(\"fileInput\") as HTMLInputElement;\nconst file = fileInput.files![0];\nawait blockBlobClient.uploadData(file);\n\n\u002F\u002F From Blob\u002FArrayBuffer\nconst arrayBuffer = new ArrayBuffer(1024);\nawait blockBlobClient.uploadData(arrayBuffer);\n```\n\n### Download Blob\n\n```typescript\nconst blobClient = containerClient.getBlobClient(\"my-file.txt\");\nconst downloadResponse = await blobClient.download();\n\n\u002F\u002F Read as string (browser & Node.js)\nconst downloaded = await streamToText(downloadResponse.readableStreamBody!);\n\nasync function streamToText(readable: NodeJS.ReadableStream): Promise\u003Cstring> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of readable) {\n    chunks.push(Buffer.from(chunk));\n  }\n  return Buffer.concat(chunks).toString(\"utf-8\");\n}\n```\n\n### Download to File (Node.js only)\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"my-file.txt\");\nawait blockBlobClient.downloadToFile(\"\u002Fpath\u002Fto\u002Flocal\u002Fdestination.txt\");\n```\n\n### Download to Buffer (Node.js only)\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"my-file.txt\");\nconst buffer = await blockBlobClient.downloadToBuffer();\nconsole.log(buffer.toString());\n```\n\n### List Blobs\n\n```typescript\n\u002F\u002F List all blobs\nfor await (const blob of containerClient.listBlobsFlat()) {\n  console.log(blob.name, blob.properties.contentLength);\n}\n\n\u002F\u002F List with prefix\nfor await (const blob of containerClient.listBlobsFlat({ prefix: \"logs\u002F\" })) {\n  console.log(blob.name);\n}\n\n\u002F\u002F List by hierarchy (virtual directories)\nfor await (const item of containerClient.listBlobsByHierarchy(\"\u002F\")) {\n  if (item.kind === \"prefix\") {\n    console.log(`Directory: ${item.name}`);\n  } else {\n    console.log(`Blob: ${item.name}`);\n  }\n}\n```\n\n### Delete Blob\n\n```typescript\nconst blobClient = containerClient.getBlobClient(\"my-file.txt\");\nawait blobClient.delete();\n\n\u002F\u002F Delete if exists\nawait blobClient.deleteIfExists();\n\n\u002F\u002F Delete with snapshots\nawait blobClient.delete({ deleteSnapshots: \"include\" });\n```\n\n### Copy Blob\n\n```typescript\nconst sourceBlobClient = containerClient.getBlobClient(\"source.txt\");\nconst destBlobClient = containerClient.getBlobClient(\"destination.txt\");\n\n\u002F\u002F Start copy operation\nconst copyPoller = await destBlobClient.beginCopyFromURL(sourceBlobClient.url);\nawait copyPoller.pollUntilDone();\n```\n\n## Blob Properties & Metadata\n\n### Get Properties\n\n```typescript\nconst blobClient = containerClient.getBlobClient(\"my-file.txt\");\nconst properties = await blobClient.getProperties();\n\nconsole.log(\"Content-Type:\", properties.contentType);\nconsole.log(\"Content-Length:\", properties.contentLength);\nconsole.log(\"Last Modified:\", properties.lastModified);\nconsole.log(\"ETag:\", properties.etag);\n```\n\n### Set Metadata\n\n```typescript\nawait blobClient.setMetadata({\n  author: \"John Doe\",\n  category: \"documents\",\n});\n```\n\n### Set HTTP Headers\n\n```typescript\nawait blobClient.setHTTPHeaders({\n  blobContentType: \"text\u002Fplain\",\n  blobCacheControl: \"max-age=3600\",\n  blobContentDisposition: \"attachment; filename=download.txt\",\n});\n```\n\n## SAS Token Generation (Node.js only)\n\n### Generate Blob SAS\n\n```typescript\nimport {\n  BlobSASPermissions,\n  generateBlobSASQueryParameters,\n  StorageSharedKeyCredential,\n} from \"@azure\u002Fstorage-blob\";\n\nconst sharedKeyCredential = new StorageSharedKeyCredential(accountName, accountKey);\n\nconst sasToken = generateBlobSASQueryParameters(\n  {\n    containerName: \"my-container\",\n    blobName: \"my-file.txt\",\n    permissions: BlobSASPermissions.parse(\"r\"), \u002F\u002F read only\n    startsOn: new Date(),\n    expiresOn: new Date(Date.now() + 3600 * 1000), \u002F\u002F 1 hour\n  },\n  sharedKeyCredential\n).toString();\n\nconst sasUrl = `https:\u002F\u002F${accountName}.blob.core.windows.net\u002Fmy-container\u002Fmy-file.txt?${sasToken}`;\n```\n\n### Generate Container SAS\n\n```typescript\nimport { ContainerSASPermissions, generateBlobSASQueryParameters } from \"@azure\u002Fstorage-blob\";\n\nconst sasToken = generateBlobSASQueryParameters(\n  {\n    containerName: \"my-container\",\n    permissions: ContainerSASPermissions.parse(\"racwdl\"), \u002F\u002F read, add, create, write, delete, list\n    expiresOn: new Date(Date.now() + 24 * 3600 * 1000), \u002F\u002F 24 hours\n  },\n  sharedKeyCredential\n).toString();\n```\n\n### Generate Account SAS\n\n```typescript\nimport {\n  AccountSASPermissions,\n  AccountSASResourceTypes,\n  AccountSASServices,\n  generateAccountSASQueryParameters,\n} from \"@azure\u002Fstorage-blob\";\n\nconst sasToken = generateAccountSASQueryParameters(\n  {\n    services: AccountSASServices.parse(\"b\").toString(), \u002F\u002F blob\n    resourceTypes: AccountSASResourceTypes.parse(\"sco\").toString(), \u002F\u002F service, container, object\n    permissions: AccountSASPermissions.parse(\"rwdlacupi\"), \u002F\u002F all permissions\n    expiresOn: new Date(Date.now() + 24 * 3600 * 1000),\n  },\n  sharedKeyCredential\n).toString();\n```\n\n## Blob Types\n\n### Block Blob (Default)\n\nMost common type for text and binary files.\n\n```typescript\nconst blockBlobClient = containerClient.getBlockBlobClient(\"document.pdf\");\nawait blockBlobClient.uploadFile(\"\u002Fpath\u002Fto\u002Fdocument.pdf\");\n```\n\n### Append Blob\n\nOptimized for append operations (logs, audit trails).\n\n```typescript\nconst appendBlobClient = containerClient.getAppendBlobClient(\"app.log\");\n\n\u002F\u002F Create the append blob\nawait appendBlobClient.create();\n\n\u002F\u002F Append data\nawait appendBlobClient.appendBlock(\"Log entry 1\\n\", 12);\nawait appendBlobClient.appendBlock(\"Log entry 2\\n\", 12);\n```\n\n### Page Blob\n\nFixed-size blobs for random read\u002Fwrite (VHDs).\n\n```typescript\nconst pageBlobClient = containerClient.getPageBlobClient(\"disk.vhd\");\n\n\u002F\u002F Create 512-byte aligned page blob\nawait pageBlobClient.create(1024 * 1024); \u002F\u002F 1MB\n\n\u002F\u002F Write pages (must be 512-byte aligned)\nconst buffer = Buffer.alloc(512);\nawait pageBlobClient.uploadPages(buffer, 0, 512);\n```\n\n## Error Handling\n\n```typescript\nimport { RestError } from \"@azure\u002Fstorage-blob\";\n\ntry {\n  await containerClient.create();\n} catch (error) {\n  if (error instanceof RestError) {\n    switch (error.statusCode) {\n      case 404:\n        console.log(\"Container not found\");\n        break;\n      case 409:\n        console.log(\"Container already exists\");\n        break;\n      case 403:\n        console.log(\"Access denied\");\n        break;\n      default:\n        console.error(`Storage error ${error.statusCode}: ${error.message}`);\n    }\n  }\n  throw error;\n}\n```\n\n## TypeScript Types Reference\n\n```typescript\nimport {\n  \u002F\u002F Clients\n  BlobServiceClient,\n  ContainerClient,\n  BlobClient,\n  BlockBlobClient,\n  AppendBlobClient,\n  PageBlobClient,\n\n  \u002F\u002F Authentication\n  StorageSharedKeyCredential,\n  AnonymousCredential,\n\n  \u002F\u002F SAS\n  BlobSASPermissions,\n  ContainerSASPermissions,\n  AccountSASPermissions,\n  AccountSASServices,\n  AccountSASResourceTypes,\n  generateBlobSASQueryParameters,\n  generateAccountSASQueryParameters,\n\n  \u002F\u002F Options & Responses\n  BlobDownloadResponseParsed,\n  BlobUploadCommonResponse,\n  ContainerCreateResponse,\n  BlobItem,\n  ContainerItem,\n\n  \u002F\u002F Errors\n  RestError,\n} from \"@azure\u002Fstorage-blob\";\n```\n\n## Best Practices\n\n1. **Use DefaultAzureCredential** — Prefer AAD over connection strings\u002Fkeys\n2. **Use streaming for large files** — `uploadStream`\u002F`downloadToFile` for files > 256MB\n3. **Set appropriate content types** — Use `setHTTPHeaders` for correct MIME types\n4. **Use SAS tokens for client access** — Generate short-lived tokens for browser uploads\n5. **Handle errors gracefully** — Check `RestError.statusCode` for specific handling\n6. **Use `*IfNotExists` methods** — For idempotent container\u002Fblob creation\n7. **Close clients** — Not required but good practice in long-running apps\n\n## Platform Differences\n\n| Feature | Node.js | Browser |\n|---------|---------|---------|\n| `StorageSharedKeyCredential` | ✅ | ❌ |\n| `uploadFile()` | ✅ | ❌ |\n| `uploadStream()` | ✅ | ❌ |\n| `downloadToFile()` | ✅ | ❌ |\n| `downloadToBuffer()` | ✅ | ❌ |\n| `uploadData()` | ✅ | ✅ |\n| SAS generation | ✅ | ❌ |\n| DefaultAzureCredential | ✅ | ❌ |\n| Anonymous\u002FSAS access | ✅ | ✅ |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n",{"name":5,"risk":28,"source":31,"date_added":42,"description":7},"2026-02-27","main","7a38d8e7073e61c16eda85681cb32fb68a8657a5","skills-store\u002Fcopilot\u002Fazure-storage-blob-ts","https:\u002F\u002Fgithub.com\u002Fsapsapshen\u002Fai-memory-router","https:\u002F\u002Fgithub.com\u002Fsapsapshen","2026-04-14 21:12:12",{"source":8,"skillName":5,"commands":50,"prompt":60,"zipAvailable":61},[51,54,57],{"tool":52,"command":53},"npx","npx skills add sapsapshen\u002Fai-memory-router --skill azure-storage-blob-ts",{"tool":55,"command":56},"bunx","bunx skills add sapsapshen\u002Fai-memory-router --skill azure-storage-blob-ts",{"tool":58,"command":59},"pnpm","pnpm dlx skills add sapsapshen\u002Fai-memory-router --skill azure-storage-blob-ts","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsapsapshen\u002Fai-memory-router\u002Fblob\u002Fmain\u002Fskills-store\u002Fcopilot\u002Fazure-storage-blob-ts\u002FSKILL.md",true,[],[64,88,114,124,137,156],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":75,"publishedAt":37},"01M71ATQRKG48SH06FQ697T5G9","wechat-search","Search WeChat Official Account articles using OpenClaw's web search and fetch capabilities with compliance-focused design.","https:\u002F\u002Fgithub.com\u002Fsapsapshen\u002Fai-memory-router\u002Fblob\u002Fmain\u002Fskills-store\u002Fopenclaw\u002Fwechat-search-release\u002FSKILL.md",[70],{"categoryNo":71,"categoryName":72,"taxonomyType":73,"taxonomyTypeDesc":74},"01JBSEEDCAT000000000000037","律师与法务","PROFESSION","适用职业",[76,77,78,79,80,81,82,83,84,85,86,87],"wechat search","wechat","search","capabilities","openclaw","design","web search","compliance","web","official","fetch","with",{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":37},"01M71ATNAVGZB35PFYM2GC5N00","trend-tap","Real-time trending topics aggregator across 7 platforms (X\u002FTwitter, Reddit, Google Trends, Hacker News, Zhihu, Bilibili, Weibo). Trigger: when user says 'trend', 'trends', 'trend tap', '热点', '热搜', or asks what is trending\u002Fhot. Do NOT use web_search — this skill already fetches live data from all platforms with zero API keys.","https:\u002F\u002Fgithub.com\u002Fsapsapshen\u002Fai-memory-router\u002Fblob\u002Fmain\u002Fskills-store\u002Fopenclaw\u002Ftrend-tap\u002FSKILL.md",[],[95,96,97,98,99,100,78,101,102,103,104,105,106,107,108,109,110,111,112,113],"trend","trend tap","tap","api keys","Bash","time","trending","hacker","aggregator","do","when","brew","live","data","google","install","read","across","api",{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":37},"01M71ATJ9AM5KM15AA8PS302EB","trend-radar","Real-time trending topics aggregator across 7 platforms (X\u002FTwitter, Reddit, Google Trends, Hacker News, Zhihu, Bilibili, Weibo). Trigger: when user says 'trend', 'trends', 'trend pulse', '热点', '热搜', or asks what is trending\u002Fhot. Do NOT use web_search — this skill already fetches live data from all platforms with zero API keys.","https:\u002F\u002Fgithub.com\u002Fsapsapshen\u002Fai-memory-router\u002Fblob\u002Fmain\u002Fskills-store\u002Fopenclaw\u002Ftrend-radar\u002FSKILL.md",[],[121,122,95,106,107,108,109,99,78,111,123,112,113,105,103,102,101,110,100,98],"trend radar","radar","pulse",{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":37},"01M71ATGF095N3EJM9G8SD0BB5","tech-news-daily","每日科技新闻汇——从全球多个 RSS 源抓取最新科技新闻，翻译（英→中）、去重、排版成每日简报。当用户询问科技新闻、科技新鲜事、每日科技、技术动态、Daily Tech News 或类似表达时触发此技能。","https:\u002F\u002Fgithub.com\u002Fsapsapshen\u002Fai-memory-router\u002Fblob\u002Fmain\u002Fskills-store\u002Fopenclaw\u002Ftech-news-daily\u002FSKILL.md",[],[131,132,133,134,135,136],"news","tech","tech news daily","daily","rss","翻译",{"skillNo":138,"name":139,"nameZh":6,"description":140,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":141,"categories":142,"keywords":148,"publishedAt":37},"01M71ATFAEAMQ17M70NQNY7SR8","summarize","Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).","https:\u002F\u002Fgithub.com\u002Fsapsapshen\u002Fai-memory-router\u002Fblob\u002Fmain\u002Fskills-store\u002Fopenclaw\u002Fsummarize\u002FSKILL.md",[143],{"categoryNo":144,"categoryName":145,"taxonomyType":146,"taxonomyTypeDesc":147},"01JBSEEDCAT000000000000021","资料检索与研究","SCENARIO","使用场景",[139,84,149,150,151,87,106,152,153,154,97,155,110],"Audio","cli","youtube","images","https","files","pdfs",{"skillNo":157,"name":158,"nameZh":6,"description":159,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":160,"categories":161,"keywords":162,"publishedAt":37},"01M71ATDNS3R0M4H936PACQAWZ","sonoscli","Control Sonos speakers (discover\u002Fstatus\u002Fplay\u002Fvolume\u002Fgroup).","https:\u002F\u002Fgithub.com\u002Fsapsapshen\u002Fai-memory-router\u002Fblob\u002Fmain\u002Fskills-store\u002Fopenclaw\u002Fsonoscli\u002FSKILL.md",[],[158,163,164,165,110,166,153,167,168,169,170,171],"status","play","go","latest","github","discover","control","cmd","volume"]