One gotcha I ran into: browser support is still spotty. Had to implement fallbacks for Firefox and Safari users (they don't fully support it yet). Ended up with a hybrid approach - File System API for Chrome/Edge, traditional file input for others.
The permission model is also interesting - users have to explicitly grant access, which builds trust but adds friction to UX. Worth it though.
What are you using it for?