doc: add information for IncomingMessage.destroy()

Add documentation for `http.IncomingMessage.prototype.destroy()`.

PR-URL: #7237
Fixes: #4226
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: cjihrig - Colin Ihrig <[email protected]>

Author: Trott

doc/api/http.md

@@ -874,6 +874,14 @@ socket has closed.
 Indicates that the underlying connection was closed.
 Just like `'end'`, this event occurs only once per response.
 
+### message.destroy([error])
+
+* `error` {Error}
+
+Calls `destroy()` on the socket that received the `IncomingMessage`. If `error`
+is provided, an `'error'` event is emitted and `error` is passed as an argument
+to any listeners on the event.
+
 ### message.headers
 
 The request/response headers object.