René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Make http.OutgoingMessage._writeRaw public","articleBody":"\u003c!--\r\nThank you for suggesting an idea to make Node.js better.\r\n\r\nPlease fill in as much of the template below as you're able.\r\n--\u003e\r\n\r\n**Is your feature request related to a problem? Please describe.**\r\n\r\nI am trying to return HTTP informational statuses to the client. In particular 100, 102, 103 but I would also like to open the door to being able to support future informational status codes.\r\n\r\nBoth 100 and 102 have a dedicated method:\r\n\r\n* `HttpServerResponse.sendContinue` for 100 and\r\n* `HttpServerResponse.sendProcessing` for 102.\r\n\r\nIt would be possible to add another function like it (sendEarlyHints), but it seems a little silly given that these informational statuses more or less follow the same structure.  \r\n\r\nThe http2 library solves this with the `additionalHeaders` function. To illustrate, this is how I send *any* informational status using http2:\r\n\r\n```javascript\r\nconst otherHeaders = { };\r\nconst status = 103;\r\n\r\nstream.additionalHeaders({\r\n   ':status': status,\r\n  ...otherHeaders\r\n});\r\n```\r\n\r\nThis is how I do it for the HTTP1 api:\r\n\r\n```javascript\r\nconst otherHeaders = { };\r\nconst status = 103;\r\nconst rawHeaders = [];\r\n  for (const headerName of Object.keys(outHeaders)) {\r\n    const headerValue = outHeaders[headerName];\r\n    if (Array.isArray(headerValue)) {\r\n      for (const headerVal of headerValue) {\r\n        rawHeaders.push(`${headerName}: ${headerVal}\\r\\n`);\r\n      }\r\n    } else {\r\n      rawHeaders.push(`${headerName}: ${headerValue}\\r\\n`);\r\n    }\r\n}\r\n\r\nconst writeRaw = promisify(res._writeRaw.bind(this.inner));\r\nconst message = `HTTP/1.1 ${status} ${http.STATUS_CODES[status]}\\r\\n${rawHeaders.join('')}\\r\\n`;\r\nawait writeRaw(message, 'ascii');\r\n```\r\n\r\nThe problem here is that I'm using `res._writeRaw`, an undocumented 'private' feature. I would like to not have to rely on this, but as far as I can tell, it's the only 'sane' way.\r\n\r\n**Describe the solution you'd like**\r\n\r\nMake `_writeRaw` a documented, supported feature OR supply a reasonable API for returning any 1xx status header. \r\n\r\n**Describe alternatives you've considered**\r\n\r\nAs far as I know there's no real alternative.","author":{"url":"https://github.com/evert","@type":"Person","name":"evert"},"datePublished":"2018-08-31T15:05:33.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":8},"url":"https://github.com/22624/node/issues/22624"}