[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-2787a28b-3abd-4066-a5f0-91f41253c41c":3,"$fH8St8XarZW4HxkYEB67En1cMTUDJjsu7M0XcUNTGw_4":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"2787a28b-3abd-4066-a5f0-91f41253c41c","azure-storage-blob-ts","Azure Blob Storage JavaScript\u002FTypeScript SDK（@azure\u002Fstorage-blob）用于blob操作。用于上传、下载、列出和管理blob和容器。","cat_coding_devops","mod_coding","sickn33,coding","---\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\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,97,1286,"2026-05-16 13:07:51",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"编程开发","coding","mdi-code-braces","代码生成、调试、审查，提升开发效率",2,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"DevOps","devops","mdi-cog-outline","CI\u002FCD、容器化、部署运维",3,162,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"136922c1-9cfe-48ed-b6ae-b59f387c063f","1.0.0","azure-storage-blob-ts.zip",3882,"uploads\u002Fskills\u002F2787a28b-3abd-4066-a5f0-91f41253c41c\u002Fazure-storage-blob-ts.zip","3a031ff0e030146e2effe2e44f7359b4c64860fa7d4605452400d15d4b22a906","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":12677}]",{"code":44,"message":45,"data":46},200,"success",{"items":47,"stats":48,"page":51},[],{"averageRating":49,"totalRatings":49,"ratingCounts":50},0,[49,49,49,49,49],{"limit":52,"offset":49,"hasMore":53,"nextOffset":52,"ratedOnly":16},15,false]